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Preface 


The IBM Series/1 Stand-Alone Utilities Guide describes each of the utility programs. 
It tells you: 

e What the utility does 

e How to use it 

e The output you receive 

e How to handle errors 


This publication is organized into seven chapters, each containing groups of related 
utility programs. Appendix M covers messages generated by each program and the 
appropriate action to be taken. 

To effectively use the stand-alone utility programs, you should be familiar with: 

e Basic data processing concepts 
e Assembler language coding 
e Modular programming concepts 


Prerequisite Publications 
none 
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Chapter 1. Introduction 


This manual explains how to use each of the utilities in detail. 


For each utility there is an example of a typical session of using the utility. This 


example shows your interaction with the utility—the prompts it issues and the responses 
you supply. It also covers errors that may occur during the interaction and how you 
handle them. The IBM-supplied names (module ID’s) for these programs are shown in 
parentheses after the program name. 


The Utilities are: 


Automatic System Build copies a portion of the complete system from a diskette to 
the system disk. 

System Verification (SF) checks to find if all components of the system were copied 
to the system disk and also prints the location of the components on disk. 

Diskette IPL Bootstrap (IP) \oads a program 1 cylinder in length (from location: 
cylinder 1, head O, sector 1) into the high end of storage. 


e Disk IPL Bootstrap/Loader (L1, L2) 1oads programs from the disk into main storage. 


Diskette Initialization (RI) initializes the diskette, writing ID records and checking for 
defective cylinders, and assigns alternate cylinders. 

Disk Initialization (FI) initializes the disk, verifying sector IDs and checking for 
defective sectors, and assigns alternate sectors. 

Create Diskette HDR1 (CH) creates a HDR1 record for a diskette, using information 
that you specify. 


e Delete Diskette HDR1 (DH) deletes the HDR1 record for a specified diskette data file. 


Diskette to Disk Copy (RF) copies data from a specified diskette data file to a 
specified disk data file. | 
Disk to Diskette Copy (FR) copies data from a specified disk data file to a specified 
diskette data file. 

Diskette to Printer Dump (RD) dumps the contents of a specified area on the diskette 
to the printer. 

Disk to Printer Dump (FD) dumps the contents of a specified area on the disk to the 
printer. 

Diskette Patch (TR) applies a patch (which you enter at the operator station) to a 
specified location on the diskette. 

Disk Patch (TF) applies a patch (which you enter at the operator station) to a 
specified location on the disk. 

Storage to Diskette Dump (SI, S2) dumps the contents of main storage to the 
diskette. 

Storage to Printer Dump (P1, P2) dumps the contents se main storage to the printer. 


| e Error Log Program (EL) formats system errors. 
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- HARDWARE OVERVIEW 


The following is a list of hardware products referred to in this manual. The list includes 
the product name and the term used within this manual when referring to the product. 


Product Name Term Used Hereafter 
IBM 4955 or 4953 Processor processor 
IBM 4962 Disk Module disk 
IBM 4964 Diskette Module diskette 
- IBM 4974 Printer . | printer 
Any device that can be used as . operator station 
an operator station and is attached 
to the system through the 


ASCII teletypewriter adapter 

The minimum hardware configuration required to runa_ Series/1 program is: 
e 1 processor with 32KB of storage 

e 1 diskette unit 

e 1 disk 

e 1 printer 

e 1 operator station 
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USING THE UTILITY PROGRAMS 


| All programs (except the Error Log Program, Automatic System Build, Storage to 
- Diskette Dump, and Storage to Printer Dump) are IPLed from the disk. All programs are 
on disk in a storage-image format, preceded by a header record designating the load point, 
entry point, size of the program, and maintenance information. 
To invoke a program, set the IPL switch to primary (disk) and press the LOAD key on 
the system console. Once the loader is in main storage, it prints a message at the operator 
station requesting the name or starting sector address of the program to be loaded: 


IP100A EXEC= 


You can enter either the 2-character name for the IBM-supplied programs (for example, 
RI for diskette initialization) or the program’s starting sector address. For any other 
programs, you must enter the program’s starting sector address. Sector addresses must be 
specified in this format: 


ccchss 

where: 

ccc = the cylinder number in decimal 
h = the head number in decimal 

SS = the sector number in decimal 


After the program is loaded, it issues prompts at the operator station requesting you to 
enter certain information needed by the program before it can begin processing. This 
information is covered in the chapters describing the individual utilities. 

The utility prints an error message at the operator station and reissues the prompt if (1) 
the information you enter is syntactically incorrect or (2) if the utility encounters a 
recoverable error. Each time a prompt or message is printed at the operator station, it 
ends with a carriage return. You must also end your entries with a carriage return. 

If you are typing a line that is longer than 72 characters, there is an automatic carriage 
return after you type the 72nd character. 

In the Series/1 programs, a contiguous, logically related collection of data on a 
single disk or diskette is called a data file. Through the operator station, you can refer to 
a data file by specifying its device address, starting sector address, and ending sector 
address. Enter the information in this format: 


ddd,ccchss,ccchss 

where: 

ddd = the device address 

ccchss,ccchss = the starting and ending sector addresses of the data file 


The device address are fixed as follows: 
Device Address Device Type 


000 operator station 
001 printer 

002 — diskette 

003 disk 


The ranges of the ccc, h, and ss values are: 
cylinder (ccc) _ head (h) sector (ss) 


Diskette—double-sided 0-74 — 0-1 1—26 
—single-sided 0-74 0 1-26 

Disk 

Disk 0—302 0-1 0—59 


Note. Cylinder 0 of the disk is reserved for the Bootstrap and Loader; cylinder 1 is 
reserved for alternate sector assignments; cylinder 302 is reserved for customer engineer 
use. On the diskette, track 0 is reserved for system use; tracks 75 and 76 are reserved as 
alternate tracks to replace tracks that become defective. 
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Both the disk and diskette are supported in a cylinder mode. For example, the disk 
sector that follows sector address 005059 is 005100, and the disk sector that follows 
sector address 005159 is 006000. 

If a logically deleted record is encountered during any diskette operation other than 
the diskette to printer dump (RD), the message UNRECOVERABLE I/O ERROR will be 
written at the operator station. The error code included in the message denotes the 
presence of a control address marker at the diskette sector address specified, and the 
function terminates. For the diskette to printer dump utility, a deleted record on cylinder 
0, head 0, sectors 8-26 and cylinder 0, head 1, sectors 1-26 will print out the message 
PHYSICAL RECORD HAS BEEN LOGICALLY DELETED. All other sectors will print 
out UNRECOVERABLE I/O ERROR. 

For more detailed information on the disk and diskette, refer to the JBM 4962 Disk 
Storage Unit Description, GA34-0024, and the IBM 4964 Diskette Input/Output Unit 
Description, GA34-0023. 

If a program creates or moves data files, it prints a message at the operator station 
indicating the last sector written: 
id099I LAST SECTOR WRITTEN = ccchss 
Messages are always printed on one device line. Some of the messages in this manual are 
shown on two lines because of the message length. 


Making Corrections at the Operator Station 
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If you should make typing errors while entering data at the operator station, you can 
correct these errors in the following manner. 
To correct one or more characters: 


You meant to type CO 10,50,100 


But you typed CO 10,60 


Now type << 50,100 


Type one left arrow (<) for each character you typed after the last correct character. Retype the 
characters correctly and continue typing. 





To correct an entire line: 


You meant to type CT 10,20,‘ABC,,‘DEF” 
But you typed CT 10,200,‘ABC’,“DEF’ 


Now type t 


Retype the line. An up arrow (+) causes a carriage return and you can correctly reenter your line. 





Note. If you want to interrupt the printing process at the operator station, hold down the 
CTRL key, then press the A key. 


Automatic System Build (SB) 


WHAT THIS PROGRAM DOES 


Chapter 2. System Build and Verification 


The Automatic System Build program copies to disk the diskette shipped from IBM. A 
copy of this program resides on the diskette. The layout of the diskette is shown below. 


ccchss 

000001 
000003 
001001 


DISKETTE 





IPL/Bootstrap 
Reserved 
Auto-System Build 

Disk IPL/Bootstrap 

Disk Loader 

System Verification 

Diskette IPL/Bootstrap 

Storage to Printer Dump (Phase A) 
Storage to Printer Dump (Phase B) 
Storage to Diskette Dump (Phase A) 
Storage to Diskette Dump (Phase B) 











Disk Initialization 
Diskette Initialization 
Create HDR1 

Delete HDR1 

Diskette to Printer Dump 








Disk to Printer Dump 
Diskette to Disk Copy 
Disk to Diskette Copy 
Diskette Patch 

Disk Patch 








Error Log 


The loader loads the contents of the diskette to a predefined area of the disk. When the 


diskette has been copied, the system is built on disk. 


HOW TO USE IT 


(1) mount the diskette, as shipped from IBM, 
set the console IPL switch to alternate, and 


(2) 


__(3) press the LOAD Key. 
The hardware loads the bootstrap, which in turn loads the Automatic System Build 
program. No further input is necessary. 


The program issues this message: 





SB000I AUTOMATIC SYSTEM BUILD STARTED 


System Build and Verification 


2-1 


Once the diskette is mounted, the program prints, from the VOL1 label, the volume 
identifier field in the following message: 


SB1001 DISKETTE VOLID=nnnnnn 


where nnnnnn is the volume identifier for the diskette. It then copies, to a predefined 
location on the disk, the contents of the diskette. There is no operator input required to 
build the system. Upon completion the program issues this message: 


SB001I AUTOMATIC SYSTEM BUILD UTILITY COMPLETED 


THE OUTPUT YOU RECEIVE 


HOW TO HANDLE ERRORS 


EXAMPLE 
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Output consists of a complete diskette copied onto the disk and the three preceding 
messages. If any errors occur while copying the diskette to disk, an appropriate I/O error 
message is printed at the operator station. 


If an I/O error occurs, the program terminates after issuing an error message to the 
operator station. See Appendix M for a complete discussion of possible error codes. 


The following is an example of the automatic system build program. In this example, the 
diskette mounted has VOLID=PIDO02. 


1. Mount the IBM diskette. 
2. Set console IPL switch to alternate. 
3. Press the LOAD Key. 


SBO00I AUTOMATIC SYSTEM BUILD STARTED 


SB100I DISKETTE VOLID=PID002 COPIED 
SB0011 AUTOMATIC SYSTEM BUILD UTILITY COMPLETED 





After the diskette is copied, your system will be built on disk. 
Now use the System Verification program to insure that the components have been 
correctly copied to the system disk. 


System Verification (SF) 
WHAT THIS PROGRAM DOES 


After you load the program, it ensures that your system is built properly by 
cross-checking each module on your IPLed system disk against a table containing 
expected module names. If any modules are missing, a message is printed indicating which 
specific program is not on the disk system. 


HOW TO USE IT 
Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either SF or the starting sector address (ccchss) of the program. When it is loaded, no 
further input is required. The program performs the verification, using an internal table of 
module names expected to be on the disk. 

THE OUTPUT YOU RECEIVE 
If your IPLed system disk is an incomplete system, an error message is printed at the 
operator station indicating the name of the module that was not found. No further 
verification processing is possible. 

The system map name contains header record data for all modules encountered before 
the error occured. If your system is correct, a system map containing header record data 
for each load module is printed, and a message verifying that the system was correctly 
built is printed at the operator station. 

The system map is printed in the following format: 

Program Name ccchss_ Entry Point Load Point Module Length User Data 

xx cechss = xXxxx VY 2222 aaaaa 

e 
e 
e 

where: 

XX = the 2-character component ID 

ccchss = the address of header record on the disk 

Xxxx = the entry point of the module in ccchss format. 

yyyy = the load point of the module in ccchss format 

ZZZZ = the length of the module in hexadecimal 

aaaaaa = the description of the 2-character component ID 

HOW TO HANDLE ERRORS 


If the program encounters any of the following errors, it issues a message at the operator 
station: 

e Invalid header ID 

¢ Module missing on system disk 

© Module name missing in the system table 

e Incorrect header chain 

If an unrecoverable error occurs, the program abnormally terminates. To reinvoke the 
program, you must reIPL. Unrecoverable errors are: . 

© Operator Station I/O error 

e Disk I/O error 
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EXAMPLE . 
The following is an example of the System Verification program. 


Operator Station Printout Explanation 


IP100A EXEC= The loader issues a request for the address of the 
program to be loaded. 


SF You enter the name of the System Verification 


program. 
SF000I SYSTEM VERIFICATION STARTED The System Verification program has started. 
xx ccchs$ *XXXXX YYVYYYY ZZZZ2Zz The system map is printed at the printer. 
SF200I SYSTEM CORRECTLY BUILT There has been a successful system verification. 
SF0011 SYSTEM VERIFICATION COMPLETE The program is finished. 
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Chapter 3. Initial Program Load Programs 


Diskette IPL Bootstrap (IP) 


WHAT THIS UTILITY DOES 
When you press the LOAD key on the console, the hardware loads the bootstrap into 
main storage from the diskette. The bootstrap, in turn, loads the contents of cylinder 1, 
head 0, from the IPLed diskette. When the bootstrap is finished, register 7 contains the 
device address of the diskette you [PLed from. The program is loaded into the high end 
of storage and control is given to the first logical address of the program. 


Note. A standard linkage editor header is required on the diskette. 


HOW TO CREATE A DISKETTE 
You must create a special diskette for the diskette IPL bootstrap. See example below. 
Locate the ccchss of the program IP on the system verification listing. Using the disk to 
diskette copy program, copy the program IP to the diskette. You must start the copy 1 
disk sector beyond the beginning of the program to remove the header record. IP must be 
placed on the diskette at cylinder 0, head 0, sectors 1 and 2. | 


HOW TO USE IT 
You invoke this utility by setting the IPL switch to alternate (diskette) and then pressing 
the LOAD key. 
Note. The bootstrap must be on cylinder 0, head 0, sectors 1 and 2 of the diskette. 
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HOW TO HANDLE ERRORS 


EXAMPLE 
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If a diskette I/O error occurs, the utility tries to recover, if it can; otherwise, it 


terminates. 


The following is an example of placing the diskette bootstrap on 4 diskette. 


Operator Station Printout Explanation 


IP100A EXEC= 

FR 

FROO1I DISK TO DISKETTE COPY 
STARTED 


FR100A FROM DATA AREA= 


003, 002126, 002126 


FR200A TO DATA AREA= 


002, 000001, 000002 


FRO99I LAST SECTOR WRITTEN IS 
000002 


FROO1I DISK TO DISKETTE COPY 
COMPLETED 


FR100A FROM DATA AREA= 


The loader issues a request for the program that is 
to be executed. 


You enter the name of the Disk to Diskette Copy 
utility. 


The Disk to Diskette Copy utility has started. 


The utility prompts for the source data file infor- 
mation. 


You enter the device address and the starting 
sector address +1 of the program IP. This re- 
moves the header record from the diskette boot- 
strap. Only one disk sector is copied. 


The utility issues this prompt for the destination 
data file information. 


You enter the device address and the starting 
sector address where the bootstrap must reside 
on cylinder 0, head 0, sectors 1 and 2. 


The utility prints the address of the last sector 
written on the diskette. 


The copy was successfully completed. 


The utility prompts for a new source data file 
for the next copy operation. 





Disk IPL Bootstrap/Loader (L1, L2) 


WHAT THIS UTILITY DOES 


HOW TO USE IT 


When you press the LOAD key on the console, the hardware loads the bootstrap into 
main storage from the disk. The bootstrap then loads and gives control to the loader. 
Once the loader is in main storage, it issues a prompt through the operator station 
requesting the two character IBM-supplied name or the ccchss location of the program 
you want loaded and given control on level 0. The loader brings into storage the program 
you request and passes control to it. 


Note. When the requested program receives control, these conditions exist: 


¢ On levels 1, 2, and 3 the LSR, IAR, and all general-purpose registers contain zeros. 
© On level 0: 
— Register 3 contains the device addresses of the operator station in the first byte and 
the printer in the second byte. 
— Register 4 contains the size of storage: 
TFFF is 32K 
BFFF is 48K 
FFFF is 64K. 
— Register 5 contains the device address of the [PLed device in the low-order byte. 
— Register 6 contains the value of the cylinder that contains the header record of the 
requested program. 
— Register 7 contains the values for the head and sector that contain the header 
record of the requested program. 
e Inthe LSR, the supervisor state bit for level 0 is on. 
e The [PLed device and the operator station are unprepared and all interrupts are 
disabled. 


You invoke this utility by pressing the LOAD key. 


Note. The bootstrap must be on cylinder 0, head 0, sector 0 of the disk. The loader 


resides on cylinder 0, head 0, sectors 1—13. 


Once the loader is in control, you can specify which program you want loaded for 


execution. The loader prints this prompt at the operator station: 





All IBM-supplied programs can be loaded by name. All user programs are loaded by disk 


address. If you load a program by name, enter: 


program name 


where: 


program name is a 2-character IBM-supplied name for the program. 
If you enter the program’s location, it must be in this form: 


ccchss 


ccc = a 3-digit decimal cylinder number in the range 002—301 
the head number, either 0 or 1 
= a 2-digit decimal sector number in the range 00—59 


nS 
Iu 
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The loader assumes that the program you requested is on the same device you IPLed- 
from. There is a restriction on how big this program can be. The program’s maximum size 
is the size of storage minus 2K bytes. The last 2K of storage is reserved for the loader, but 
may be used after control is passed to the program. 

If the information you enter is syntactically incorrect, an error message is printed at the 
operator station and the prompt is repeated. If the information you enter is syntactically 
correct, the loader checks your program’s header record to determine: 

e Ifit is a valid header 

© The load point of the program 

e The entry point of the program 

e Ifthe program can fit into the available storage 


If an invalid header is found, the prompt is reissued. If the information is correct, your 
program is given control. 


THE OUTPUT YOU RECEIVE 


HOW TO HANDLE ERRORS 
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The only output from this utility is the prompt IP100A EXEC= and possibly some error 
messages. 


If the utility encounters a recoverable error, it prints an error message and reissues the 

prompt. Recoverable errors are: 

e Invalid sector address—address is out of range for the device, contains non-decimal 
digits, or is the incorrect length 

e Invalid header record 

© Invalid program name 

¢ Program too large for storage 


If the utility encounters an unrecoverable error, it issues a LEX with a code in the 


operand of the instruction. To reinvoke the utility, you must reIPL. Unrecoverable errors 
are: 

e I/O error to the operator station 

e 1/0 error to disk 
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Diskette Initialization (RI) 


WHAT THIS UTILITY DOES 
This utility initializes either a single-side or double-sided diskette in a diskette drive. The 
initialization consists of three steps: 
e The utility formats each track into 128-byte sectors. 
e The utility analyzes each track. If it finds a defective sector, it considers that entire 
cylinder to be defective, and assigns an alternate cylinder. The next sequential cylinder 
is assigned as the alternate. If more than two cylinders are defective, the diskette is 
flagged as unusable. 
e On cylinder 0, head 0, the utility: 
— Writes the VOLID (volume identification) on sector 7. 
— Writes one HDR1 (header 1) on sector 8. This HDR1 describes the entire data area 
(cylinders 1-74) as one data set. 
— Writes the remaining HDR1s (9-26) as deleted headers. 
— Writes the ERRMAP on sector 5. This contains the address of defective cylinders up 
to a maximum of two in the format cch, where cc is the number of the defective 
cylinder and h is the head number. 


See the following pages for the format of the VOL1 and HDRI field. 


If you try to initialize a diskette that has been previously initialized, you destroy all 
data on the diskette. Reinitialization rewrites the complete diskette surface. 


VOL1 LABEL FORMAT 


Character Initialization 
Position Field Name = Value 


Label Identifier ‘VOL’ 
Label Number 1 
Volume Identifier _ user id 
Accessibility space 


Reserved spaces 


Owner ID spaces 


Reserved spaces 


Volume Surface Indicator space (single-sided) 
2 (double-sided) 


Reserved space 
Physical Record Length space 
Physical Record Sequence Code spaces 
Reserved space 
Labet-Standard Version ‘w’ 
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HDR1i LABEL FORMAT 


Character Field Initialized 
Position Name Length Value 


Label Identifier ‘HDR’ 
Label Number 1 


Reserved space 


File ID 8 char DSNs 
+ 9 blanks 


00128 


space 


Block Length 

Record Attribute 
Beginning of Extent 
Physical Record Length 
End of Extent 
Record/Block Format 
Bypass Indicator 


cchss 
space 
cchss 
space 
space 
File Security space 
Write Protect Indicator space 
Exchange Type Indicator 
Multi-Volume File 

Volume Sequence Indicator 
Creation Date 

Record Length 

Offset To Next Record Space 
Reserved 


Expiration Date 


space 
space 
space 
space 
space 
space 
space 
space 
Verify/Copy Indicator space 
File Organization 
End of Data Address 
Reserved 


space 


cchss 


=a OA = SB HH Pw Lh DN KK Fe FF |& KF KF OHS AR wD 


space 





The initialized diskette that this utility produces is formatted as a basic exchange 
diskette, with a VOLID that you specify. The portion of the diskette that is available for 
your use (cylinders 1—74) is a basic exchange EBCDIC data file. It is specified by the first 
HDRI1 record (at cylinder 0, head 0, sector 8). The basic exchange data file has these 
characteristics: 

e The data file is organized sequentially. 

e Arecord is 128 bytes long. 

e Records are in fixed-length format and are unblocked and unspanned. 

e The physical record length is 128 bytes. 

¢ The data file identifier (HDR1) is a simple name, containing up to 8 characters. 

e All character data is represented in EBCDIC. ASCII is not supported. 
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HOW TO USE IT 


Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either RI or the starting sector address (ccchss) of the utility. When it is loaded, the 
utility responds with: 





The utility issues this prompt requesting the diskette device address: 





Enter the information in this form: 


where ddd is the device address, in decimal. This number must be in the range 0-127. 
If the diskette already has a VOLID, the utility responds with: | 





where cccccc is the name of the current VOLID on the diskette. The utility issues a 
prompt asking whether or not to proceed with initializing this diskette: 





If you respond NO, the utility issues a cycle terminated message and recycles to the 
RI110A message. If you respond YES, the utility issues this prompt requesting the name 
of your volume: 





Enter the VOLID you want on your volume in this form: 


where cccccc is a 1-to 6-character alphameric name. 


If the information you entered is correct the utility does the initialization. 
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THE OUTPUT YOU RECEI 


HOW TO HANDLE ERRORS 


EXAMPLE 
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VE 


This utility produces an initialized diskette in basic exchange format (one that is 
interchangeable with other systems). If any defective cylinders are encountered, the 
utility issues this message, one for each defective cylinder, in the following form: 





where cc is the number of the defective cylinder and h is the head number. The utility 
prints this message to indicate that it has finished: 





If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are: 

e Device address not valid 

Device at specified device address not diskette device 

Invalid VOLID/header name 

Cylinder 0 defective 

Unable to initialize because there are too many defective cylinders (two cylinders is 
the maximum) 

e Cylinder 0 unformatted 


If the utility encounters an unrecoverable I/O error, it abnormally terminates. To 


_reinvoke the initialization utility, you must reIPL. 


The following example shows a typical initialization, where the diskette device address is 
002, the user’s new VOLID is VOLOO1, and the old VOLID is VOL999. 


Operator Station Printout Explanation 


IP100A EXEC= The loader issues a request for the program that is 
to be loaded. 


RI You enter the name of the Diskette Initialization 
utility. 


FIO00I DISKETTE INITIALIZATION The Diskette Initialization utility has started. 
STARTED 


RIL10A DEVICE ADDRESS= The utility issues a request for the device address 
of the Diskette. 


002 The diskette is at device address 002. 
RI125I CURRENT VOLID = VOL999 The current name of your diskette is VOL999. 


RI127A DO YOU WANT TO INITIALIZE This prompt asks you if you wish to continue to 
THIS DISKETTE? RESPOND YES OR NO | _ initialize this diskette. 


YES You respond YES to continue. 


RI120A NEW VOLID= The utility issues a request for you to supply the 
new VOLID. 


VOLO01 The new name of your diskette is VOLOO1. 
RI140I DEFECTIVE CYLINDER 110 These two cylinders have bad sectors. 


RI140I DEFECTIVE CYLINDER 270 This message is not printed if all cylinders are 
good. 


RI0011I DISKETTE INITIALIZATION The diskette is initialized. 
COMPLETED 


Disk Initialization (FI) 
WHAT THIS UTILITY DOES 


HOW TO USE IT 


This utility has two initialization types—primary initialization and alternate sector 
assignment. 

Use primary initialization for complete initialization when the disk is installed or when 
complete reinitialization is desired. It first verifies and corrects sector IDs, and then 
analyzes the disk surface to find defective sectors. When it finds a defective sector, it. 
assigns an alternate sector on cylinder 1, then prints a message at the operator station. 

Alternate sector assignment lets you assign alternate sectors for those sectors found to 

be defective. It also tries to move data from the defective sector to the alternate. 
Note. Because there are only 120 alternate sectors available, and because once an 
alternate has been assigned, the defective sector cannot be recovered unless you specify 
that all sector IDs are to be rewritten during initialization. Therefore, use alternate sector 
assignment only when necessary. 


If you try to initialize a disk that has been previously initialized, you destroy all data on 
the disk. Reinitialization rewrites the complete disk surface. 


Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either FI or the starting sector address (ccchss) of the utility. When it is loaded, the utility 
responds with: 





The utility then issues this prompt requesting the device address of the disk to be 
initialized. 





Enter the requested information in this form: 


where ddd is the disk device address. This number must be in decimal, in the range 
0-255. 


The utility then issues this prompt requesting the type of initialization you want to 
perform: 





Enter the requested information in this form: 


where tt is the initialization type. Enter PI for primary initialization, or AS for alternate 
sector assignment. The utility’s next action depends on the initialization type you 
entered. If you entered PI, the utility issues this prompt requesting you to specify 
whether the defective sector flags are invalid: 
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Enter either YES or NO. If you respond YES, the utility rewrites all sector IDs and — 
reinitializes the flag byte, where possible. If you py NO, the defective sector flag bit of 
each sector ID is retained. 


Note. You should respond YES only if you want to rewrite all the sector IDs. Rewriting 
the sector IDs causes the loss of the IBM assigned defective sector flags. 

If you entered AS, the utility issues this prompt requesting you to specify the defective 
sector address: 





Enter the requested information in this form: 


ccchss 


where ccchss is the address of a sector that you have found to be defective. The utility 
assigns an. alternate sector on cylinder 1 and then tries to move the data from the 
defective sector onto the alternate. 


THE OUTPUT YOU RECEIVE 


If you request primary initialization, the utility prints a message for each defective sector 
it finds. The message looks like this: 
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where ccchss is the address of the defective sector. A successful assignment of an alternate 
in AS mode prints the same message. When the utility has finished either type of 
initialization, it prints this message: | 





HOW TO HANDLE ERRORS 


EXAMPLES 


IP100A EXEC= 


FI 


FIOOOI DISK INITIALIZATION STARTED 
FI110A DEVICE ADDRESS= 


075 


FI120A TYPE= 


PI 


If the utility encounters a recoverable error, while processing your input to the operator 
station, it prints an error message and reissues the prompt. Recoverable errors are: 


Device address not valid (for example, defective character, out of range, not 3 
characters) 


¢ Device at specified device address not a disk device 
e Invalid initialization type—must be either AS or PI 
e Invalid sector address (for example, out of disk range, invalid character, not 6 


characters) 
Invalid response to sector flag prompt 


The following error types cause a warning message, but allow for normal program 
completion without any response from you. 


Unable to recover data in alternate sector mode 
Unable to write sector ID 
Defective sector on cylinder 1 


If the utility encounters one of the following three unrecoverable errors, it abnormally 
terminates. To reinvoke the initialization utility, you must reIPL. 


Unable to assign an alternate sector because alternate cylinder is full 
Unable to initialize because there are too many defective sectors (the maximum is 120 
sectors) 


© Unrecoverable I/O error 
e Attempt to assign alternate for defective sector on cylinder 1 
e Unexpected or invalid return codes from external system routines 


The following example shows a typical primary initialization session for a disk at device 
address 075. 


Operator Station Printout Explanation 


The loader issues a request for the program that is 
to be executed. 


You enter the name of the Disk Initialization 
utility. 
The disk initialization utility started. 


The utility issues a request for the device address 
of the disk to be initialized. 


- The disk is at device address 075. 


The utility issues a request for the type of 
initialization you want. 


You request a primary initialization. 


FI003I PRIMARY INITIALIZATION MODE 


FI1S0A ARE DEFECTIVE SECTOR 
FLAGS INVALID 


NO 


FI1401 ALTERNATE SECTOR 
ASSIGNED FOR 240120 


FI140I ALTERNATE SECTOR 
ASSIGNED FOR 240140 


FI0011 DISK INITIALIZATION COMPLETED 


The utility enter primary mode. 


The utility issues a request to find if the defective 
flags are invalid. 


You specify that the defective sector flags are 
valid. 


The utility assigned alternate sectors for defective 
sectors 240120 and 240140. 


The utility is finished. 
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The next example shows a typical alternate sector assignment session. 


Operator Station Printout Explanation 


IP100A EXEC= The loader issues a request for the program that is 
to be executed. 

ccchss You enter the starting sector address of the Disk 
Initialization utility. 

FIOOOI DISK INITIALIZATION STARTED The Disk Initialization has started. 

FI110A DEVICE ADDRESS= The utility requests the device address of the Disk 
to be initialized. 

003 The disk is at device address 003. 


FI120A TYPE= The utility issues a request for the type of 


initialization you want. 

AS You request alternate sector assignment. 

FIO0041 ALTERNATE SECTOR MODE The utility issues a message telling you that 
alternate sector assignment is ready. 

FI130A SECTOR ADDRESS= , The utility issues a request for the sector you want 
an alternate assigned for. 

100037 The defective sector is sector 100037, 

FI140 ALTERNATE SECTOR ASSIGNED The utility issues a message that the sector 
assignment is successful. 

FIO01I DISK INITIALIZATION The utility is finished. 

COMPLETED 
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Chapter 5. Create and Delete Programs 


Create Diskette HDR1 (CH) 


WHAT THIS UTILITY DOES 


HOW TO USE IT 


Using information that you supply, this utility creates a basic exchange HDR1 record for 
a diskette data file. If you want to create a HDR1 of any other format, see the JBM 
General Information Manual, GA21-9182-1. 

If the diskette initialization utility initialized the diskette, the HDR1 describing the 
extents of the entire diskette must be deleted before the utility can create any additional 
HDRIs. 


Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either CH or the starting sector address (ccchss) of the utility. After it is loaded, the 
utility issues this message: 


CHO00I CREATE HDR1 UTILITY STARTED 


The utility then issues this prompt requesting the diskette device address: 





Enter the requested information in this form: 


where ddd is the diskette device address, in decimal. This number must be in the range 
0-127. 


The utility issues this prompt requesting the name of your data file described by the 
HDRI1 record. 





Enter the requested information in this form: 


ecccccce 


where ccccccce is a 1-to 8-character alphameric name. The utility issues this prompt 
requesting the starting and ending sector addresses of the data file to be defined by this 
HDRI1 record. . 
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Enter the information in this form: 


ccchss,ccchss 


where ccchss,ccchss are the starting and ending sector addresses of the next data file. The 
utility issues this prompt requesting the address, within the data file, to write the last data 
item. 





Enter the information in this form: 


ccchss 


where ccchss is the address of the next sector in the data file available for data. If you 
enter the information correctly the utility creates the HDR1 record. 


THE OUTPUT YOU RECEIVE 
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This utility writes a HDRI1 record to the diskette. When the utility has finished 
successfully, it prints this message: 


CH001I CREATE HDR1 UTILITY COMPLETED 


When the utility completes unsuccessfully, an error message is printed along with the 
following message: 


| CH299T CREATE HDRI ABNORMAL CYCLE END 


The utility then initiates another CREATE operation by reissuing the DEVICE 
ADDRESS prompt. The utility continues in this mode until you terminate it by pressing 
the LOAD key. The following is a description of the HDR1 fields that will be initialized 


by this utility. 


Character 
Position 


Label Identifier 
Label Number 
Reserved 

Data File ID 


Block Length 

Record Attribute 
Beginning of Extent 
Physical Record Length 
End Of Extent 
Record/Block Format 
Bypass Indicator 

Data File Security 

Write Protect Indicator 
Exchange Type Indicator 
Multi-Volume Data File 
Volume Sequence Indicator 
Creation Date 

Record Length 
Offset To Next Record Space 
Reserved 

Expiration Date 
Verify/Copy Indicator 
Data File Organization 

End Of Data Address 


Reserved 


*_This is the data you entered 





5 
1 
5 
1 
5 
1 
1 
1 
1 
1 
1 
5 
6 
4 
5 
4 
6 
1 
1 
5 
1 


Initialized 
Value 


‘HDR’ 
1 
space 


8 char.*DSNs 
+9 blanks 


00128 


‘space 


cchss* 
space 
cchss* 
space 
space 
space 
space 
space 
space 
space 
space 
space 
space 
space 
space 
space 
space 
cchss* 


space 
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HOW TO HANDLE ERRORS 


EXAMPLE 
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If the utility encounters a recoverable error, it prints an error message and reissues the 


prompt. Recoverable errors are: 


Invalid ccchss 


Wrong number of arguments 

Device at specified device address not a diskette device 

End of file address you specified not within the data extents 
Data file extents in conflict with each other 

Invalid data file name 

Invalid device address 


e Extents not in basic exchange data area 

If the utility encounters an unrecoverable error, it abnormally terminates the CREATE 
operation with an abnormal cycle end message. The utility then recycles to the prompt 
for the device address. The unrecoverable errors are: 


Data file overlaps an existing data file 
No available HDR1s 

Extent arrangement indicator incompatible with the data file extents requested 
Name you entered duplicates one that already exists on the volume 
Unrecoverable I/O error 

VOLID is not compatible with the basic exchange data file 

Invalid HDR1 on diskette 


The following example shows a typical create HDR1 session: 


IP100A EXEC= 


CH 


CHOO0OI CREATE HDR1 
UTILITY STARTED 


CH110A DEVICE ADDRESS= 


050 
CH120A HEADER NAME= 


VOLDATA2 
CH130A EXTENTS= 


037015,038025 


CH140A END OF FILE= 
038001 


CH001I CREATE HDR1 
UTILITY COMPLETED 


CH110A DEVICE ADDRESS= 





Operator Station Printout Explanation 


The loader issues a request for the program that is 
to be executed. 


You enter the name of the Create HDR1 utility. 


The Create HDR1 utility has started. 


The utility issues a request for the device address 
of the diskette. 


‘The Diskette is at device address 050. 


The utility issues a request for the name you want 
to give your HDR1 record. 


You enter VOLDATA2. 


The utility issues a request for where you want to 
locate your data file. 


The data file éxtends from sector 037015 to sector 
038025. 


Enter the sector address of the last data item. 
The data ends at sector 038001. 
The HDRI1 record is created. 


This prompt initiates another CREATE operation. 


Delete Diskette HDR1 (DH) 


WHAT THIS UTILITY DOES 


HOW TO USE IT 


This utility deletes the HDR1 record for a specified data file and rewrites it as unused. 


Press the LOAD Key. After the EXEC= message is printed at the operator station, enter 
either DH or the starting sector address (ccchss) of the utility. When it is loaded, the 
utility issues this message: 





The utility then issues this prompt requesting the diskette device address: 





Enter the requested information in the following form: 


where ddd is a 3-digit decimal number in the range O—127. The utility enters this prompt 
requesting the name of the HDR1 record you want to delete: 





Enter the information in this form: 


cceccccce 


where cccccccc is a l-to 8-character alphameric name. If the information you enter is 
correct, and there are no other errors, the utility deletes the HDR1. 


THE OUTPUT YOU RECEIVE 


This utility rewrites the HDR1 record as unused. When the utility has successfully 
finished, it prints: 





or if the utility is unsuccessful, it prints: 





The utility then initiates another DELETE HDR1 operation, and reissues the DEVICE 
ADDRESS= prompt. The utility will continue in this mode until you press the LOAD 
key. 
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HOW TO HANDLE ERRORS 


EXAMPLE | 
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If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are: 

e Invalid device address 

e Device at specified device address not a diskette device 

e Invalid data file name 


If the utility encounters an unrecoverable error, it abnormally terminates the delete cycle. 
The utility then recycles to the prompt for the device address. The unrecoverable errors 
are: : 

Extent arrangement indicator incompatible with the data file extents to be deleted 
HDRI name not found 

Unrecoverable I/O error 

VOLID incompatible for basic exchange data sets 

Invalid HDR1 on diskette 


The following example shows a typical delete HDR1 session: 


Operator Station Printout Explanation 


IP100A EXEC= The loader issues a request for the program that is 
to be executed. 


DH You enter the name of the Delete HDR1_ utility. 


DHO00I DELETE UTILITY HDRI1 

STARTED 

DH110A DEVICE ADDRESS= The utility requests the device address of the 
Diskette. 


The Delete HDR1 utility has started. 


002 The Diskette is at device address 002. 

DH120A HEADER NAME= The utility issues a request for the name of the 
HDR1 record you want deleted. 

VOLDATA2 The name of the HDRI record is VOLDATA2. 

DH001I DELETE HDR1 UTILITY The HDR1 record is deleted. 

COMPLETED 


DH110A DEVICE ADDRESS= The utility initiates another DELETE HDRI 
operation. 
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Diskette To Disk Copy (RF) 


WHAT THIS UTILITY DOES 


After you load this utility, it copies a specified data file from a diskette to a disk. There 
are two diskette sectors per disk sector. 


HOW TO USE IT 


Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either RF or the starting sector address (ccchss) of this utility. When it is loaded, the 
utility responds with: 





The utility issues this prompt for the source data file information: 





Enter the information in this form: 


ddd,ccchss,ccchss 


where: 

ddd = the diskette device address in decimal 

ccchss,ccchss = the starting and ending sector addresses 
delimiting the location of the data file information to be copied 
from the diskette 


The utility issues this prompt for the destination data file information: 





Enter the information in this form: 


ddd,ccchss,ccchss 


where: 
ddd = the disk device address in decimal 
cechss,ccchss = the starting and ending sector addresses delimiting the location on 


disk into which the data file information is to be copied 
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If there are no errors, the utility checks the size of the destination data file. If the 
destination data file is too small, the utility issues an error message and recycles; 
otherwise, it performs the copy as you requested. If you copy an odd number of diskette 
sectors, the utility pads (with zeros) the last 128 bytes of the last disk sector written. 
Once the copy is completed, a completion message is written at the operator station and 
followed by another prompt for source data file information. The utility will continue in 
this mode until you terminate it in some manner (for example, by pressing the LOAD 
key). 


THE OUTPUT YOU RECEIVE 


When this utility has finished copying the information you requested, it prints this 
message at the operator station: 


HOW TO HANDLE ERRORS 
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where: 
ccchss = the last sector written on the disk. 


After that message, it prints: 





This indicates that the copy is completed. The utility then reissues the FROM DATA 
AREA= prompt. 


If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are: 


e Response parameter too short or too long 

e Response does not have three parameters 

e Invalid device address (negative number, non-decimal digits, or greater than 255) 

e Device at specified device address not diskette device (for source) or disk device (for 
destination) 

e Invalid sector address (out of range, non-decimal digits, or wrong number of 
characters) 

e Starting sector address greater than ending sector address 

e Source data file larger than the destination data file 

If the utility encounters an unrecoverable I/O error to the disk or diskette, it 

abnormally terminates the cycle with an error message and reissues the FROM DATA 

AREA= prompt. If an unrecoverable error occurs at the operator station, the utility 

terminates. . 


EXAMPLE 


The following is an example of the diskette to disk copy utility. The diskette device 
address is 002, with starting sector address 037015 and ending sector address 037125. 
The disk device address is 003, with starting sector address 240120 and ending sector 


address 240140. 


Operator Station Printout Explanation 


IP100A EXEC= 


RF 


RFOOOI DISKETTE TO DISK COPY STARTED 


RF100A FROM DATA AREA= 
003,037015,037125 

RF007A INCORRECT DEVICE TYPE-— 
MUST BE DISKETTE 


RF100A FROM DATA AREA= 


002,037015,037125 


RF200A TO DATA AREA= 


003,240120,240140 


RFO99I LAST SECTOR WRITTEN IS 240138 
RFO011 DISKETTE TO DISK COPY 
COMPLETED 

RF100A FROM DATA AREA= 


The loader issues a request for the program that is 
to be executed. 

You enter the name of the Diskette to Disk Copy 
utility. 

The Diskette to Disk Copy utility has started. 

The utility prompts for the source data file 
information. 

You enter the device address, starting sector 
address, and the ending sector address for the 
source data file information. 

The device type is incorrect. 


The utility reissues the prompt for the source data 
file information. 

You enter the correct device address, starting 
sector address, and ending sector address for the 
source data file information. 

The utility issues this prompt for the destination 
data file information. 

You enter the device address, starting sector 
address, and ending sector address for the 
destination data file. 

The address of the last sector written on the disk. 
The copy was successfully completed. 


The utility prompts for a new source data file for 
the next copy function. 
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Disk To Diskette Copy (FR) 


WHAT THIS UTILITY DOES 


HOW TO USE IT 
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After you load this utility, it copies a specified data file from a disk to a diskette. There 
are two diskette sectors per disk sector. . 


Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either FR or the starting sector address (ccchss) of the utility. When it is loaded, the 
utility responds with: 





The utility issues this prompt for the source data file information: 





Enter the information in this form: 


ddd,ccchss,ccchss 


where: 

ddd = the disk device address in decimal 

ccchss,ccchss = the starting and ending sector addresses 
delimiting the location of the data file information to be copied 
from the disk 


The utility issues this prompt for the destination data file information: 





Enter the information in this form: 


ddd,ccchss,ccchss 


where: 
ddd = the diskette device address in decimal 
ccchss,ccchss = the starting and ending sector addresses delimiting the location on 


the diskette into which the data file information is to be copied 
If there are no errors, the utility checks the size of the destination data file. If the 
destination data file is too small, the utility issues an error message and recycles. 
Otherwise, it performs the copy as you requested. Once the copy is completed, a 
completion message will be written at the operator station and followed by another 
prompt requesting source data file information. The utility will continue in this mode 
until you terminate it in some manner (for example, by pressing the LOAD key). 


THE OUTPUT YOU RECEIVE 
When this utility has finished copying the information you requested, it prints this 
message at the operator station: 





where: 
ccchss = the last sector written on the diskette 
After that message, it prints: 





This indicates that the copy is completed. The utility then reissues the FROM DATA 
AREA= prompt. 


HOW TO HANDLE ERRORS 


If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are: 


¢ Response parameter too short or too long 
_©@ Response does not have three parameters 
e Invalid device address (negative number, non-decimal digits, or greater than 255) 
e Device at the specified device address not a disk device (for source) or diskette device 
(for destination) 
e Invalid sector address (out of range, non-decimal digits or wrong number of characters) 
e Starting sector address greater than ending sector address 
e Source data file larger than destination data file 
If the utility encounters an unrecoverable I/O error to the disk or diskette, it abnormally 
terminates the cycle with an error message and reissues the FROM DATA AREA= 
prompt. 
If an unrecoverable I/O error occurs at the operator station, the utility terminates. 
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EXAMPLE 
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The following is an example of the disk to diskette copy utility. The disk device address is 
003, with starting sector address 240120 and ending sector address 240140. The diskette 
device address is 002, with starting sector address 037015 and ending sector. address 
039010. 


Operator Station Printout Explanation 


IP100A EXEC= 

FR 

FROOOI DISK TO DISKETTE COPY 
STARTED 

FR100A FROM DATA AREA= 


003,240120,240140 


FR200A TO DATA AREA= 


002,039010,037015 


FRO16A END SECTOR LESS THAN 
START SECTOR 
FR200A TO DATA AREA= 


002,037015,039010 


FRO99I LAST SECTOR WRITTEN IS 038004 


FROOII DISK TO DISKETTE COPY 
COMPLETED 
FR100A FROM DATA AREA= 


The loader issues a request for the program that is 
to be executed. 

You enter the name of the Disk to Diskette Copy 
utility, 

The Disk to Diskette Copy utility has started. 


The utility prompts for the source data file 
information. 

You enter the device address, starting sector 
address, and the ending sector address for the 
source data file information. 

The utility issues this prompt for the destination 
data file information. 

You enter the device . address, starting sector 
address and the ending sector address for the 
destination data file information. 

The information entered is incorrect. 


The utility reissues the prompt for the destination 
data file information. 

You enter the correct device address, starting 
sector address, and ending sector address for the 
destination data file. ; 

The utility prints the address of the last sector 
written on the diskette. 

The copy was successfully completed. 


The utility prompts for a new source data file for 
the next copy operation. 





Diskette To Printer Dump (RD) 


WHAT THIS UTILITY DOES 


HOW TO USEIT 


This utility dumps the contents of a specified data file from the diskette on the printer. 


Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either RD or the starting sector address (ccchss) of the utility. When it is loaded, the 
utility prints this message at the operator station: 





The utility prints this prompt for the location of the data file information to be dumped 
from the diskette: 





Enter the requested information in this form: 


ddd,ccchss,ccchss 


where: 
ddd = the diskette device address in decimal 
ecchss,ccchss = the starting and ending sector addresses 


delimiting the location of the data file information to be dumped 

from the diskette. 
If there are no errors, the utility dumps the requested data file information on the 
printer. You may stop the dump by causing an interrupt from the operator station. To do 
this, hold down the CTRL key, then press the A key. This causes the dump to stop at the 
end of a print line, print an abnormal recycle message, and reprompt for new input. Once 
the dump operation is finished, a completion message is written at the operator station 
and followed by a prompt for the next source data file information to be dumped. The 
utility continues in this mode until you terminate it in some manner (for example, by 
pressing the LOAD key). 


THE OUTPUT YOU RECEIVE 


This utility dumps the contents of a specified data file from the diskette on the printer. 
The dump is in hexadecimal with columns of EBCDIC translation to the right of the page 
and is formatted by sectors in the following manner: 


ccchss XXXX XXXX<---- 12 words ---->XXXX XXXX YYYYYYYYYYYYYYYYYYYYYYYYYYYyyyyy 
XXXX XXXX<--«- 12 words --*->XXXX XXXX YYYYVYYYYYYYYYYYYYYYYYYYYYYYYyyy 


XXXX XXXX<-~-- 12 wordse--*>XXXX XXXX_ YYYYYYYYYYYYY YY YYYYYYYYYYYYYYYYY 





XXXX XXXX<---- 12 words---->xXXXX XXXX YYYYYYYYYYVYYYYYYYYYYYYYYYYYYyyy 


where: 

ccchss = the sector address of the data on the diskette 
XXXX = the contents of the diskette sector in hexadecimal 
yyyy = the contents of the diskette sector in EBCDIC 
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lif the utility encounters a deleted header record on cylinder 0 sectors 8-26, head O or 
sectors 1-26, head 1, it prints the message PHYSICAL RECORD HAS BEEN 
LOGICALLY DELETED on the printer. The message is preceded by the ccchss address. 


When the dump is finished, the utility issues this message at the operator station: 





It then reissues the DISK AREA= prompt. 


HOW TO HANDLE ERRORS 


If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are: 

e Response to prompt does not have three parameters 

e Invalid device address 

e Device at the specified device address not a diskette device 

e Invalid sector address 

e Starting sector address greater than ending sector address 


If the utility encounters an unrecoverable diskette device I/O error, it abnormally 
terminates and reissues the DISK AREA= prompt. If the utility encounters an 
unrecoverable operator station or printer I/O error, it terminates. 


EXAMPLE 


The following is an example of a dump from the diskette on the printer. The diskette 
device address is 002 with a starting sector address of 030015 and an ending sector 
address of 030016. 


Operator Station Printout Explanation 


IP100A EXEC= The loader issues a request for the program that is 
to be executed. 

RD You enter the name of the Diskette to Printer 
Dump utility. 

RDOOOI DISKETTE TO PRINTER The Diskette to Printer dump has started. 

DUMP STARTED 

RD100A DISK AREA= ‘The utility prompts for the disk sectors to be 
dumped. 


F02,030015,030016 You enter the device address, starting sector 
address, and ending sector address for the dump, 

RDO004A INVALID DEVICE ADDRESS— The device address is incorrect. 

NON-DECIMAL DIGIT 


RD100A DISK AREA= The utility reissues a prompt for the disk sectors to 
be dumped. 
002,030015,030016 You enter the correct address for the disk. 
RDOO1I DISKETTE TO PRINTER The dump was successfully completed. 
DUMP COMPLETED 
RD100A DISK AREA= The utility prompts for the next data file to be 
dumped. 
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Disk To Printer Dump (FD) 


WHAT THIS UTILITY DOES 


HOW TO USE IT 


This utility dumps the contents of a specified data file from the disk on the printer. 


Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either FD or the starting sector address (ccchss) of the utility. When it is loaded, the 
utility prints this message at the operator station: 





The utility prints this prompt for the location of the data file information to be dumped 
from the disk: 





Enter the requested information in this form: 


ddd,ccchss,ccchss 


where: 


‘ddd = the disk device address in decimal 
ccchss,ccchss = starting and ending sector addresses delimiting the location of the 
data file information to be dumped from the disk 

If there are no errors, the utility dumps the requested data file information on the 
printer. You may stop the dump by causing an interrupt from the operator station. To do 
this, hold down the CTRL key, then press the A key. This causes the dump to stop at the 
end of a print line, print an abnormal recycle message, and reprompt for new input. Once 
the dump operation is completed, a completion message is written at the operator station 
and followed by a prompt for the next source data file information to be dumped. The 
utility continues in this mode until you terminate it in some manner (for example, by 
pressing the LOAD key). 


THE OUTPUT YOU RECEIVE 


This utility dumps the contents of a specified data file on the printer. The dump is in 
hexadecimal with columns of EBCDIC translation to the right of the page and is 
formatted by sectors in the following manner: 


Xxxx<— 12 words —>XXXx YVYVYYYYYYYYYYYYYYYYYYYYYYYYYYYy 
XXXX<-— 12 words —>XXxx YYYYYYYYYYYYYYYYYYYYYYYYYYYYYyyy 
XXXX<-— 12 words —>XXXX YYYYYYVYYYYYYYYYYYYYYYYYYYYYYYYYy 
XXXX<— 12 words —>Xxxx YYYYYYYYYYYYYYYYYYYYYYYYYYYyyyvy 


XXXX<=— 12 words —>XXxx YYYYYYYYYYVYYYYYYYYYYYYYYYYYYyyy 
XXXx<— 12 words —->Xxxx YYYYYY YYYYYYYY YYYYYYYYYYYYYYYyyy 
XXXx<-—— 12 words ~>xXxxx YYYYYYYYYYYYYYYYYYYYYYYYYYYYyyyy 
XXXX<—— 12 words —>XXxx YYY YYYYYYYYYYYYYYYYYYYYYYYYYYyyy 
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where: 


ccchss _ = the sector address of the data file on the disk 
XXXX the contents of the disk sector in hexadecimal 
yyyy the contents of the disk sector in EBCDIC 


When the dump is finished, the utility issues this message at the operator station: 





It then reissues the DISK AREA= prompt. 


HOW TO HANDLE ERRORS 


If the utility encounters a recoverable error, it prints an error message and reissues the 
prompt. Recoverable errors are: 


e Response to the prompt does not have three parameters 
e Invalid device address 

e Device at specified device address not disk device 

e Invalid sector address 

e Starting sector address greater than ending sector address 


If the utility encounters an unrecoverable disk I/O error, it abnormally terminates and 
reissues the DISK AREA= prompt. If the utility encounters an unrecoverable operation 
station or printer I/O error, it terminates. 


EXAMPLE 


The following is an example of a dump from the disk on the printer. The disk device 
address is 003, with a starting sector address of 200130 and an ending sector address of 
200131. 


Operator Station Printout Explanation 


IP100A EXEC= The loader issues a request for the program that is 
to be executed. 

FD You enter the name of the Disk to Printer Dump 
utility. 

FDOOOI DISK TO PRINTER DUMP The Disk to Printer Dump utility has started. 

STARTED 

FD100A DISK AREA= The utility prompts for the disk sectors to be 

dumped. 

F03,200130,200131 You enter device address, starting sector address, 
and ending sector address for the dump. 

FD004A INVALID DEVICE ADDRESS— The device address is incorrect. 

NON DECIMAL DIGIT 

FD100A DISK AREA= The utility reissues a prompt for the disk 
sectors to be dumped. 

003,200130,200131 You enter the correct address for the disk. 

FDOO1I DISK TO PRINTER DUMP The dump was successfully completed. 

COMPLETED 

FD100A DISK AREA= The utility prompts for the next data file to be 
dumped. 
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Diskette Patch (TR) 
WHAT THIS UTILITY DOES 


HOW TO USE IT 


This utility applies a patch which you enter at the operator station to a specified area on 
the diskette. 


Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either TR or the starting sector address (ccchss) of this utility. When it is loaded, the 
utility responds with: 





The utility issues this prompt for the location on the diskette you want to patch: 





Enter the requested information in the following form: 


ddd,ccchss,bbb,nnn 


where: 

ddd = the diskette device address in decimal, in the range O—127 

ccchss = the sector address of the area to be patched 

bbb = the byte displacement in decimal, within the sector, where you want 
the patch to start 

nnn = the number of bytes you want displayed for verification before the 
patch is applied 


This number must not exceed 128. All bytes printed for verification 
must be within the boundaries of the sector you specified; that is, 
the sum of bbb + nnn must be less than 129. 


If there are no errors, the utility prints the bytes that you requested for verification and 
then prints this prompt on the next line: 





If the bytes printed for verification do not.begin with the bytes you want to patch, enter 
this response: 


NONE 


The utility responds: 





It then reissues the PATCH AREA= prompt. 
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If the bytes printed for verification begin with the ones you want to patch, enter the. 
patch in the following form: 


hhhh hhhh hhhh ... 


where: 

hhhh hhhh hhhh... are groups of four hexadecimal characters, separated by blanks 
The length of the patch must be in the range of 1 to 128 bytes. 
The entire patch must be within the boundaries of the sector you 
specified. Note that the length of the patch does not have to 
equal the value you specified for nnn (the byte verification 
count). 

If there are no errors, the patch is applied. 


The utility responds with: 


TROO1I DISKETTE PATCH COMPLETED 


The utility issues the completion message which is followed by the prompt for the next 
patch. The utility continues in this mode until you terminate it by pressing the LOAD 
key. 


THE OUTPUT YOU RECEIVE 


The output from this utility are prompt messages from the utility and the data for the 
requested patch to diskette. 


HOW TO HANDLE ERRORS — 
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If a recoverable error occurs, the utility prints an appropriate error message and then 
reissues the prompt. Recoverable errors are: 


e Syntax error in your response to a prompt 


© Device at specified device address not a diskette 


e Sector address not a valid address for diskette 

e Displacement not within the boundaries of the sector you specified 

e Number of bytes to be displayed either exceeds 128 or less than or equal to zero 

If an unrecoverable diskette I/O error occurs, the utility abnormally terminates. A 
terminal error occurs when an I/O error prevents the utility from printing a message at . 
the operator station. . 


EXAMPLE 


The following example shows what happens when you apply a patch to the diskette. 


Operator Station Printout 


IPLOO0A EXEC= 


TR 
TROOOI DISKETTE PATCH STARTED 
TR200A PATCH AREA= 


02, 003003, 24, 08 
TRO03A INVALID DEVICE ADDRESS— 
3 DIGITS REQUIRED 


TR200A PATCH AREA= 


002, 003003, 24, 08 


TR101A INVALID DISPLACEMENT— 
3 DIGITS REQUIRED 


TR200A PATCH AREA= 


002,003003, 024, 08 


TR105A INVALID BYTE VERIFICATION 
COUNT-—3 DIGITS REQUIRED 


TR200A PATCH AREA= 


002, 003003, 024, 008 


000A 123B 0101 ADOC 


TR201A REPLACEMENT DATA= 


NONE 
TROO1I DISKETTE PATCH COMPLETED 
TR200A PATCH AREA= 


Explanation 


The loader issues a request for the program that 
is to be executed. 


You enter the name of the Diskette Patch utility. 


The Diskette Patch utility has started. 


The utility issues a request for the address of 
the location to be patched. 


You enter the device address, sector address, 
byte displacement, and byte verification count. 


The device address is incorrect. 


The utility reissues the prompt for the address 
of the location to be patched. 


You enter the correct device address, sector 
address, byte displacement, and byte verifica- 
tion count. 


The byte displacement is incorrect. 


The utility reissues the prompt for the address 
of the location to be patched. 


You enter the device address, sector address, 
correct byte displacement, and byte verifica- 
tion count. 


The byte verification count is incorrect. 


The utility reissues the prompt for the address 
of the location to be patched. 


You enter the device address, sector address, 
byte displacement, and the correct byte veri- 
fication count. 


These are the 8 bytes requested for verification. 


The utility issues a request for you to enter a 
patch or cancel this particular patch operation. 


No patch is to be applied. 
The patch cycle was successfully completed. 


The utility prompts for the next patch cycle. 
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Disk Patch (TF) 
WHAT THIS UTILITY DOES 


HOW TO USE IT 
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This utility applies a patch which you enter at the operator station to a specified area on 
the disk. 


Press the LOAD key. After the EXEC= message is printed at the operator station, enter 
either TF or the starting sector address (ccchss) of this utility. When it is loaded, the 
utility issues this message: 





The utility issues this prompt for the location on the disk you want to patch: 





Enter the requested information in the following form: 


ddd,ccchss,bbb,nnn 


where: 

ddd = the disk device address in decimal in the range O—255 

ccchss = the sector address of the area to be patched 

bbb = the byte displacement in decimal, within the sector, where you want 
the patch to start . 

nnn = the number of bytes you want displayed for verification before the 


patch is applied 

This number must not exceed 256. All bytes printed for verification 
must be within the boundaries of the sector you specified; that is, 
the sum of bbb + nnn must be less than 257. 


If there are no errors, the utility prints the bytes that you requested for verification and 


_then prints this prompt on the next line: 





If the bytes printed for verification do not begin with the bytes you want to patch, enter 
this response: 


NONE 


The utility responds with: 





It then reissues the PATCH AREA= prompt. If the bytes printed for verification ie 
with the ones you want to patch, enter the patch in the following form: 


hhhh hhhh hhhh ... 


where: 

hhhh hhhh hhhh.... are groups of four hexadecimal characters, separated by blanks 
The length of the patch must be in the range of 1 to 256 bytes. 
The entire patch must be within the boundaries of the sector you 
specified. Note that the length of the patch does not have to 
equal the value you specified for nnn (the byte verification 
count). 

If there are no errors, the patch is applied. 

The utility responds with: 





The utility issues the completion message which is followed by the prompt for the next 
patch. The utility continues in this mode until you terminate it by pressing the LOAD 
key. 


THE OUTPUT YOU RECEIVE 
The output from this utility are prompt messages from the utility and the data for the 
requested patch to diskette. 


HOW TO HANDLE ERRORS 
If a recoverable error occurs, the utility prints an appropriate error message and then 
reissues the prompt. Recoverable errors are: 
e Syntax error in your response to a prompt 
e Device at specified device address not a disk 
e Sector address not a valid disk address 
e Displacement not within the boundaries of the sector you specified 
e Number of bytes to be displayed exceeds 256 
If an unrecoverable disk I/O error occurs, the utility abnormally terminates. A ‘seminal 
error occurs when an I/O error prevents the utility from printing a message at the 
operator station. 


} 
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EXAMPLE 
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The following example shows what happens when you apply a patch to the disk. 


IP100 EXEC= 
TF 


TFOOOI DISK 
PATCH STARTED 
TF200A PATCH AREA= 


03,003003,24,08 


TF003A INVALID DEVICE ADDRESS— 
3 DIGITS REQUIRED 


TF200A PATCH AREA= 


003,003003,24,08 


TF101A INVALID DISPLACEMENT-3 
DIGITS REQUIRED 


TF200A PATCH AREA= 


003,003003,024,08 


TF105A INVALID BYTE VERIFICATION 
COUNT-—3 DIGITS REQUIRED 


TF200A PATCH AREA= 


003,003003,024,008 


000A 123B 0101 AOOC 
TF201 A REPLACEMENT DATA= 


NONE 

TFOO1I DISK 

PATCH COMPLETED 
TF200A PATCH AREA= 


Operator Station Printout Explanation 


The loader issues a request for the program that is 
to be executed. 
You enter the name of the Disk Patch utility. 


The Disk Patch utility has started. 


The utility issues a request for the address of the 
location to be patched. 

You enter the device address, sector address, byte 
displacement, and the byte verification count. 


The device address is incorrect. 


The utility reissues the prompt for the address of 
the area to be patched. 


You enter the correct device address, sector 
address, byte displacement, and the byte 
verification count. 


The byte displacement is incorrect. 


The utility reissues the prompt for the address of 
the area to be patched. 


You enter the device address, sector address, 
correct byte displacement, and the byte 
verification count. 


The byte verification count is invalid. 


The utility reissues the prompt for the address of 
the area to be patched. 


You enter the device address, sector address, byte 
displacement, and the correct byte verification 
count. 


These are the 8 bytes requested for verification. 


The utility issues a request for you to enter a patch 
or cancel this particular patch operation. 


No patch is applied, 
The patch cycle was successfully completed. 


The utility prompts for the next patch cycle. 


Storage To Diskette Dump (S1) 


WHAT THIS UTILITY DOES 


When you press the LOAD key on the console, the hardware loads this utility into main 
storage from a pre-built dedicated diskette. The utility then dumps the contents of 
storage to that same diskette. 


HOW TO CREATE THE DISKETTE 


You must create a special diskette for the storage to diskette dump. 

Locate the ccchss of the program S1 on the system verification listing. Using the disk to 
diskette copy program, copy the program S1 to the dedicated diskette. You must start 
the copy 1 disk sector beyond the beginning of the program to remove the header record. 
S1 must be placed on the diskette at cylinder 0, head 0, sectors 1 and 2. 

Next, copy the second phase of the program to the dedicated diskette. Locate the 
ccechss of the program S2 on the system verification listing. Using the disk to diskette 
copy program, copy the program S2 to cylinder 1, head 0, sectors 1 through 26 of the 
diskette. Once this is done, the diskette is ready for you to use. 


HOW TO USE IT 
Mount the special storage to diskette dump on the fixed address diskette device and set 
the switch to alternate. After you press the LOAD key, the dump starts at storage address 
256 and continues until all storage has been dumped. The first 256 bytes are destroyed 
by the loading of the dump program. Also, on level 0, the IAR is altered by the dump. 
THE OUTPUT YOU RECEIVE 


The output from this utility is the storage dump onto the diskette. The HDR1 record 
looks like this: 
bytes 00—03 HDRI1 
05—21 data set identifier indicating that this is a dump data set ($SRISTED) 
22—26 the block length, which is 128 
28—32 the starting address of the dump, which is cylinder 2, head 0, sector 


1 
This area appears in cchss format and contains 02001. 

33 the physical record length, which is 128 

34—38 the ending address of the dump, which the utility provides in cchss 
format 


74—78 the end of data address, which is updated by the dump program 
This is the format of the dump. 
Beginning at cylinder 2, head 0, sector 1: 


| e TAR, general-purpose register, AKR and LSR for each level 


e The address in storage where the dump begins 
Beginning at cylinder 3, head 0, sector 1 is the storage dump. 
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HOW TO HANDLE ERRORS 


EXAMPLE | 
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If the utility encounters any recoverable errors during the dump, the utility tries to 
recover. However, if the error is unrecoverable, the processor stops. 


The following is an example of building a diskette for the Storage to Diskette Dump 


utility. 


Operator Station Printout 


IP100A EXEC= 

ER 

FRO01I DISK TO DISKETTE COPY 
STARTED 

FR100A FROM DATA AREA= 


003, 002143, 002143 


FR200A TO DATA AREA= 


002, 000001, 000002 


FRO99I LAST SECTOR WRITTEN IS 
000002 


FROO1I DISK TO DISKETTE COPY . 


COMPLETED 
FR100A FROM DATA AREA= 


003, 002144, 002152 


FR200A TO DATA AREA= 


002, 001001, 001026 


FRO99I LAST SECTOR WRITTEN IS 
001026 


_ FROO1I DISK TO DISKETTE COPY 
COMPLETED 


FR100A FROM DATA AREA= 


The loader issues a request for the program that 
is to be executed. 


You enter the name of the Disk to Diskette Copy 
utility. 
The Disk to Diskette Copy utility has started. 


The utility prompts for the source data file 
information. 


You enter the device address and the starting 
sector address +1 of the program S1. This re- 
moves the header record from the diskette 
bootstrap. Only one disk sector is copied, 


The utility issues this prompt for the destination 
data file information. 


You enter the device address and the starting 
sector address where the bootstrap must reside 
on cylinder 0, head 0, sectors 1 and 2. , 


The utility prints the address of the last sector 
written on the diskette. 


The copy was successfully completed. 


The utility prompts for the source data file 
information. 


You enter the device address and the starting 
sector address of the program S2. This copy 
must include the header and the program. 


The utility issues this prompt for the destination 
data file information. 


You enter the device address and the starting 
sector address where the Phase 2 of the program 
must reside on cylinder 1, head 0, sectors 1—26. 


The utility prints the address of the last sector 
written on the diskette. It may be something 
less than sector 26. 


The copy was successfully completed. 


The utility prompts for a new source data file 
for the next copy operation. 





Storage To Printer Dump (P1) 


WHAT THIS UTILITY DOES 


When you press the LOAD key on the console, the hardware loads this utility from a 
dedicated pre-built diskette. The utility then dumps the contents of storage on the 
printer. 


HOW TO CREATE THE DISKETTE 


HOW TO USE IT 


You must create a special diskette for the storage to diskette dump. 

Locate the ccchss of the program P1 on the system verification listing. Using the disk to 
diskette copy program, copy the program P1 to the dedicated diskette. You must start 
the copy 1 disk sector beyond the beginning of the program to remove the header record. 
P1 must be placed on the diskette at cylinder 0, head 0, sectors 1 and 2. 

Next, copy the second phase of the program to the dedicated diskette. Locate the 
ccchss of the program P2 on the system verification listing. Using the disk to diskette | 
copy program, copy the program P2 to cylinder 1, head 0, sectors 1 through 26 of the 
diskette. Once this is done, the diskette is ready for you to use. 


Set the IPL switch to alternate (diskette) and mount the pre-built storage to printer dump 
on the fixed address diskette device. After you press the LOAD key, the level status 
blocks for all levels are printed. No messages are printed at the operator station. 

Note. If the full function console is available and the system is in the diagnostic mode, 
the program stops and allows you to enter in R1 a hex starting address of X0100’ or 
higher and to enter in R2 a hex ending address; otherwise, the dump starts at decimal 
location 256 and continues until the end of storage. On level 0, the IAR is altered by the 
dump. 

When the system is in the diagnostic mode and a selected area has been printed, the 
program stops allowing a new entry to be made in R1 and R2. At any time an area is 
being printed, press the console INTERRUPT key to interrupt the program and select a 
new area to be dumped. The program will continue to wait for additional input until 
terminated by hitting the RESET button or IPL LOAD button. 
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THE OUTPUT YOU RECEIVE 


The output from this utility is the storage dump on the printer. The data is dumped on 
the printer in the following format: 
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mn iiii kkkk 1111) xxxx xxxx xxxxX XXXX XXXX XXXX XXXX XXXX 


aaaa hhhh hhhh ¢-------- 12 words- ) hhhh hhhh eeee(24 char)eeee 





aaaa hhhh hhhh ¢-------- 12 words- > hhhh hhhh eeee(24 chareeee 


where: 


aaaa 
eece = 


: 


iii 


: 


Hil 


XXXX = 


= the address of the leftmost byte of storage 


the valid EBCDIC character or a period for an invalid character 
the contents of storage 

the contents of the IAR 

the contents of the AKR 


= the contents of the LSR 


the interrupt level number 


The number n and the line to the right of the n are printed four 
times—once for each level 


the contents of the general-purpose rigisters 


The storage dump will always start on a doubleword boundary. 


Note. This program uses cylinder 3, head 0, sectors 1 thru 26 as a temporary work area 
on the IPLed diskette. 


HOW TO HANDLE ERRORS 


EXAMPLE 


If it encounters any errors during the dump, the utility tries to recover. However, if the 
error is unrecoverable, the processor stops. 


The following is an example of building a diskette for the Storage to Printer Dump 
utility. 


Operator Station Printout Explanation 


IP100A EXEC= The loader issues a request for the program that 
is to be executed. 











FR You enter the name of the Disk to Diskette Copy 


utility. 
The Disk to Diskette Copy utility has started. 














FROO1I DISK TO DISKETTE COPY 
STARTED 


FR100A FROM DATA AREA= 











The utility prompts for the source data file 
information. 








003, 002128, 002128 You enter the device address and the starting 
sector address +1 of the program P1. This re- 
moves the header record from the diskette 


bootstrap. Only one disk sector is copied. 











FR200A TO DATA AREA= The utility issues this prompt fro the destination 


_ data file information. 













002, 000001, 000002 You enter the device address and the starting 
sector address where the bootstrap must reside 


on cylinder 0, head 0, sectors 1 and 2. 

















FRO0991 LAST SECTOR WRITTEN IS 
000002 


FROO1I DISK TO DISKETTE COPY 
COMPLETED 


FR100A FROM DATA AREA= 


The utility prints the address of the last sector 
written on the diskette. 





The copy was successfully completed. 











The utility prompts for the source data file 
information. 











You enter the device address and the starting 
sector address of the program P2. This copy 
must include the header and the program, 


003, 002129, 002141 














FR200A TO DATA AREA= The utility issues this prompt for the destination 


data file information. 















002, 001001, 001026 You enter the device address and the starting 
sector address where the Phase 2 of the program 


must reside on cylinder 1, head 0, sectors 1—26. 


The utility prints the address of the last sector 
written in the diskette. It may be something less 
than sector 26. 












FRO99I LAST SECTOR WRITTEN IS 
001026 






FROO1I DISK TO DISKETTE COPY 
COMPLETED 


FR100A FROM DATA AREA= 









The copy was successfully completed. 






The utility prompts for a new source data file 
for the next copy operation. 
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Chapter 7. Error Log (EL) 


WHAT THIS PROGRAM DOES 


The purpose of the error log program is to record machine and program errors such as 
program checks, I/O errors, machine checks, soft-exception checks, and null interrupts. 
The error log program will: 


e Log the error in two buffers that you define. 

e Format the log entry so that you can, with your own routine, either list the record on 
a print device or write it to a disk or diskette. 

e Format the log entry into binary. 


Input to SELERLOG $ELERLOG Output User Routine 






















EBCDIC Buf- 
fer in print- 
able hexa- 
decimal 


Parameter List 

Address of Error 

Log Control Block 

Buffer 
Address of Binary 
Buffer 


Error Indicator 


Routine to 
write log 


EBCDIC 
Buffer 






to disk or 
print device 





Binary Buf- 
fer in 
Binary 











Binary 
Buffer 


EAR ee 








ae aR 


You must set up an error log control block, which will contain information regarding the 
error. Then define two buffers: one to hold the formatted log in hexadecimal EBCDIC 
characters; and, one to hold the formatted log in binary. The error indicator is required 
to specify the type of error being logged, and a parameter list must point to the locations 
of the first three items and must specify the error indicator. 
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HOW TO USE IT 


Error Indicators 
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Do a branch and link instruction to SELERLOG, storing your return address in register 7, 
after link-editing the error log program to your own program. (To locate the error log 
program, see “Automatic System Build (SB)” in Chapter 2.) Register 0 must point to a 
word-aligned parameter list with the following information: 


The address of the error log control block. 

The address of the EBCDIC buffer, which will hold the formatted error. 

The address of the binary buffer, which will hold the formatted error in binary. 
The error indicator, which must specify the type of error encountered. 


Only one error can be logged in the message area at a time, so you must store the 
message on a disk or diskette or write it to a printer before calling the error log program 
again. Since the error log program must use some privileged instructions, it must run in 
supervisor state. 


The format of the error log control block and the completed buffers will vary, depending 
on the error type encountered. Use the following identifying letters to specify the error 
type to the error log program in the error log control block: 


DE = specifies a device error 

TO = specifies an I/O timeout 

MC = specifies a machine check 

PC = specifies a program check 

SC = specifies a soft-exception check 
NI = specifies a null interrupt 


Error Log Control Block 


You must set up the error log control block in the following three formats and make 
available the information for the items listed. 


Size in 
a Field name Contents 
0 0 


Interrupt Level The interrupt level that is assigned 
to the I/O device with program 
control. 


DE or TO Error Indicators: 


Device ID Specifies the ID of the device on 
which the error occurred. 


Retry Count Specifies the number of times the 
error has been tried. 


Blank Space Necessary to start IDCB on even byte. 


Address of IDCB Specifies the address in storage of the 
Immediate Device Control Block. 


OIO Condition Code Specifies the condition code follow- 
ing the command Operate I/O 


instruction, 


Interrupt Condition Specifies the condition code when 
Code the interrupt was accepted. 


ISB Specifies the Interrupt Status Byte. 


Number of CSSW’s Specifies the number of cycle steal 
status words for the device named 
in Device ID. 


-First Cycle Steal Status Word. 
Second Cycle Steal Status Word. 
Third Cycle Steal Status Word. 
Fourth Cycle Steal Status Word. 
Fifth Cycle Steal Status Word. 





MC, PC, or SC Error Indicators: 






Size in 
ae Field name Contents 


0 Interrupt Level The interrupt level that is assigned 
to the I/O device with program 
control. 
Address of LSB The address of the Level Status Block. 
4 PSW The Program Status Word. 
Error Address The address when the error was 
encountered. 
Active Address Key The address key in use when the error 
is encountered (4955 only). 
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NI Error Indicator: 


EBCDIC Buffer 


Binary Buffer 







Size in 
bytes Field name Contents 


0 0 2 Interrupt Level The interrupt level that is assigned 
; to the I/O device with program 
control. 
2 2 2 Interrupt ID Consists of an interrupt information 
. byte and the device address. 


See IBM Series/1 Model 5 4955 Processor and Processor Features Description, GA34-0021 or IBM 
Series/1 Model 3 4953 Processor and Processor Features Description, GA34-0022 for extended 
discussions of the items to be specified above. 












The EBCDIC buffer will hold the formatted error when the error log program has 
completed processing. This buffer must be word aligned and must have enough space to 
contain the largest formatted error — 368 bytes. 


The binary buffer will hold the formatted error in binary form. This buffer must be word 
aligned and must have enough space to contain the largest formatted error — 124 bytes. 


THE OUTPUT YOU RECEIVE 
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The error log program will extract the data it required from the error log control block. 
It then formats the data into hexadecimal characters in one of the following forms so 
that, with a program you provide or with a utility, you can take the data from the 
EBCDIC buffer and list the records using a printer device, or you can write the records 
on a disk or diskette. 


EBCDIC Buffer Output 


DE or TO Error Indicators: 


Displacement 


in bytes Size in 


bytes. 
0 


Re RP PP BP PR 


Field name 
Reserved Zeros 
Blank Space 


Interrupt Level 


Blank Space 


AKR (Address Key 
Register) 


Blank Space 
Device ID 


Blank Space 
Retry Count 


Blank Space 
IDCB 


Blank Space 


OIO Condition Code 


Interrupt Condition 


Code 

ISB 

Blank Space 
Number of CSSW’s 


Blank Space 
CSswl 
Blank Space 
CSSW2 
Blank Space 
CSSW3 
Blank Space 
CSSW4 
Blank Space 
CSSWS5 


Contents 


Non-significant zeros. 


The interrupt level that is assigned 
to the I/O device with program 
control. 


The contents of the Address Key 
Register (4955 only). 


Specifies the ID of the device on 
which the error occurred. 


Specifies the number of times the 
error has been tried. 


Contains an I/O command that 
describes the specific nature of the 
I/O operation. 


Specifies the condition code follow- 


ing the command Operate I/O 
instruction. 


Specifies the condition code when 
the interrupt was accepted. 


Specifies the Interrupt Status Byte. 


‘The number of Cycle Steal Status 


Words. 


First Cycle Steal Status Word. 


Second Cycle Steal Status Word. 


Third Cycle Steal Status Word. 


Fourth Cycle Steal Status Word. 


Fifth Cycle Steal Status Word. 
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DE or TO Indicators Continued: 


Displacement 
in bytes Size in 


bytes Field name Contents 


Blank Space - 


_ Descriptive Text *1/O Timeout” or “Device Error’ 


> 


DCB Word 1 Device-dependent control word— 
see individual device publication 
for definition. 


Blank Space — 


DCB Word 2 Device-dependent control word— 
see individual device publication 
for definition. 


Blank Space — 
DCB Word 3 Device-dependent control word—- 


see individual device publication 
for definition. 


Blank Space _ 


DCB Word 4 Device-dependent control word— 
see individual device publication 


for definition. 


Repeated for Blank Space e 


each DCB— 
to maximum DCB Word 5 Device-dependent control word— 
of five DCBs. see individual device publication 


for definition. 
Blank Space = 


DCB Word 6 Device-dependent control word— 
see individual device publication 
for definition. 

Blank Space = 


DCB Word 7 Device-dependent control word— 
see individual device publication 
for definition. 


Blank Space = 


DCB Word 8 Device-dependent control word— 
see individual device publication 
for definition. 


Blank Space _ 
Descriptive Text “Device Error - DCB” 
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MC, PC, or SC Error Indicators: 


NI Error Indicator: 


Displacement 
in bytes 


0 0 


Displacement 
in bytes 


Field name 
Reserved Zeros 
Blank Space 


Interrupt Level 


Blank Space 


AKR (Address Key 
Register) 


Blank Space 
PSW 

Blank Space 
Error Address 


Blank Space 
Active Address 


Blank Space 
JAR 


Blank Space 
LSR 
Blank Space 


Descriptive Text 


Field name 
Reserved Zeros 
Blank Space 


Interrupt Level 


Blank Space 


AKR (Address Key 
Register) 


Blank Space 
ISB 

Blank Space 
Device Address 
Blank Space 


Descriptive Text 


Contents 


Non-significant zeros. 


The interrupt level that is 
assigned to the I/O device 
with program control. 


The contents of the Address Key 
Register (4955 only). 


The Program Status Word. 


The address when the error was 
encountered. 


The address key in use when the 
error is encountered (4955 only). 


The 16-bit register that holds the 
main storage address used to fetch 
an instruction. 


The Level Status Register. 


“Program Check”, “Machine Check”’, 
or “Soft Exception Check”. 





Contents 


Non-significant zeros. 


The interrupt level that is assigned 
to the I/O device with program 
control. 


The contents of the Address Key 
Register (4955 only). 


Specifies the Interrupt Status Byte. 


The I/O device address. 


“Null Interrupt”. 





See IBM Series/1 Model 5 4955 Processor and Processor Features Description, GA34-0021 or IBM 
Series/1 Model 3 4953 Processor and Processor Features Description, GA34-0022 for extended 
discussions of the items to be specified above. 
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Binary Buffer Output 


DE or TO Error Indicators: 
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Displacement 
in bytes | Size in 


bytes 


Dee. 


Field name 
Reserved Zeros 


AKR (Address Key 
Register) 


Reserved Zeros 


Interrupt Level 


Device ID 


IDCB 


Reserved Zeros 


Retry Count 


OIO Condition 
Code 


Interrupt Condition 
Code 


ISB 

Reserved Zeros 
CSSWl 

CSSW2 

CSSW3 

CSSW4 

CSSWS 

DCB1 


DCB2 
DCB3 
DCB4 


DCBS 


Contents 
Non-significant zeros. 


The contents of the Address Key 
Register (4955 only). 


Non-significant zeros. 


The interrupt level that is assigned 
to the I/O device with program 
control. 


Specifies the ID of the device on 
which the error occurred. 


Contains an I/O command that 
describes the specific nature of 
the I/O operation. 


Non-significant zeros. 


Specifies the number of times the 
error has been tried. 


Specifies the condition code 
following the command Operate 
I/O instruction. 


Specifies the condition code when 
the interrupt was accepted. 


Specifies the Interrupt Status Byte. 
Non-significant zeros. 

First Cycle Steal Status Word. 
Second Cycle Steal Status Word. 
Third Cycle Steal Status Word. 
Fourth Cycle Steal Status Word. 
Fifth Cycle Steal Status Word. 


Up to five DCBs can be chained, 
this is the first one. 


Up to five DCBs can be chained, 
this is the second. 


Up to five DCBs can be chained, 
this is the third. 


Up to five DCBs can be chained, 
this is the fourth. 


Up to five DCBs can be chained, 
this is the fifth. 





MC, PC, or SC Error Indicators: 


NI Error Indicators: 


Displacement _ 
in bytes Size in 


bytes 


me NY NY NY NY NY NY NY KY KY KY WY 


Displacement 
in bytes Size in 
bytes 


0 
6 


Field name 
Reserved Zeros 


AKR (Address Key 
Register) 


Reserved Zeros 


Interrupt Level 


Error Address 


IAR 


Active Address Key 


LSR 
Register 0 
Register 1 
Register 2 
Register 3 
Register 4 
Register 5 
Register 6 
Register 7 
Reserved Zeros 
PSW 


Reserved Zeros 


Field name 
Reserved Zeros 


AKR (Address Key 
Register) 


Reserved Zeros 


Interrupt Level 


Interrupt ID 


Contents 
Non-significant zeros. 


The contents of the Address Key 
Register (4955 only). 


Non-significant zeros. 


The interrupt level that is assigned 
to the I/O device with program 
control. 


The address when the error was 
encountered. 


The 16-bit register that holds the 
main storage address used to fetch 
an instruction. 


The address Key in use when the error 
is encountered (4955 only). 


The Level Status Register. 


' The contents of Register 0. 


The contents of Register 1. 
The contents of Register 2. 
The contents of Register 3. 
The contents of Register 4. 
The contents of Register 5. 
The contents of Register 6. 


The contents of Register 7. 


Non-significant zeros. 
The Program Status Word. 


Non-significant zeros. 





Contents 
Non-significant zeros. 


The contents of the Address Key 
Register (4955 only). 


Non-significant zeros. 


The interrupt level that is assigned 
to the I/O device with program 
control. 


Consists of an interrupt 
information byte and the device 
address. 





See IBM Series/1 Model 5 4955 Processor and Processor Features Description, GA34-0021 or IBM 
Series/1 Model 3 4953 Processor and Processor Features Description, GA34-0022 for extended 
discussions of the items to be specified above. 
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HOW TO HANDLE ERRORS 


After regaining control from the error log program, your program should check the 
contents of register 0. If register 0 equals O, the error log program executed correctly. If 
the register contains a minus 1, you specified an invalid error indicator in your error log 
control block input. To recover from an error, correct your input and call the error log 
program again. 
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Appendix M. Messages 


This appendix contains in numeric order within each component the following: 


e Common messages relating to normal initiation/termination and messages caused by 
incorrect user responses to common prompts which require the following input: 


ddd,ccchss,ccchss 
where: 
ddd — Device address 
ccchss — Starting sector address 
cechss — Ending sector address 


¢ Unrecoverable I/O and system messages 
¢ Component prompt type messages and unique component messages 
e Wait code messages for the following utilities: 
IP—BOOTSTRAP/LOADER DISK 
S1—STORAGE TO DISKETTE DUMP 
P1—STORAGE TO PRINTER DUMP 
Note. You must have a full function console to see the wait code messages. These 
wait code messages appear at the end of the messages for each of the above utilities. 


All messages in this appendix are in the following format: 


idnnne text 

id — 2-character ID of the component 

nnn — 3-digit decimal number identifying the message 
Cc — message type: 


A — Action; operator response to printed message required 
W — Warning; minor error detected; successful operation possible 


I — Informational; comment printed; no error 
E — Error detected; current operation terminated but program 
continues 


S — Severe Error condition; execution of program impossible 
T — Terminal Error; program aborts 


Create Diskette HDR1 
Delete Diskette HDR1 
Disk ‘to Printer Dump 
Disk Initialization 

Disk to Diskette Copy 
IPL Bootstrap/Loader Disk 
Storage to Printer Dump 
Diskette to Printer Dump 
Diskette to Disk Copy 
Diskette Initialization 
Automatic System Build 
System Verification 
Storage to Diskette Dump 
Disk Patch 

Diskette Patch 





Messages M-1 


COMMON MESSAGES 


_ Message and Explanation | a System Action 
id000I program name STARTED 
This message is issued after the None. 


processing program has been loaded 
and processing is started. 


idOO1I program name COMPLETED 
_ This message is issued after the 
processing program has completed 
its processing, 


Program terminates. 


id002E INCORRECT NUMBER OF PARMS - 3 REQUIRED 
The device address, starting sector Reprompts. 
address, and ending sector address 
‘must be given, 


id003E INVALID DEVICE ADDRESS - 3 DIGITS REQUIRED 
Device address must be 3 digits. Reprompts. 


id004E INVALID DEVICE ADDRESS - NON-DECIMAL DIGIT 
Device address must be decimal Reprompts. 
digits. 


id00SE DEVICE ADDRESS OUT OF RANGE .- 
Device address must be within range Reprompts. 
of 0 to 255. 


id006E INCORRECT DEVICE TYPE - MUST BE DISK - AT DEVICE ddd 
Device used must be disk. Reprompts. 


id007E INCORRECT DEVICE TYPE - MUST BE DISKETTE -AT DEVICE ddd 
Device used must be diskette. Reprompts. 


id010E INVALID STARTING SECTOR ADDRESS - 6 DIGITS REQUIRED 
Starting sector address must be 6 Reprompts. 
digits. 


idO11E INVALID STARTING SECTOR ADDRESS - NON-DECIMAL DIGIT 
Starting sector address must be Reprompts. 
decimal digits. , 


id012E STARTING SECTOR ADDRESS OUT OF RANGE FOR DEVICE ddd 


Starting sector address range is Reprompts. 
as follows: 


DISKETTE 000-074 0-1 1-26 
DISK 000-302 0-1 0-59 


id013E INVALID ENDING SECTOR ADDRESS - 6 DIGITS REQUIRED 









Ending sector address must be 6 Reprompts. 
digits. 

id014E INVALID ENDING SECTOR ADDRESS - NON-DECIMAL DIGIT 
Ending sector address must be Reprompts. 
decimal digits. 


M-2. GC34-0070 


Your Action 


None. 


None. 


Reenter the response. 


Reenter the response. 


Reenter the response. 


Reenter the response. 


Reenter the response. 


Reenter the response. 


Reenter the response. 


Reenter the response. 


Reenter the response. 


Reenter the response. 


Reenter the response, 


id015E 


id016E 


id018A 


id019E 


id020E 


id021E 


id022E 


id030E 


id031A. 


id032A 


Message and Explanation System Action 


ENDING SECTOR ADDRESS OUT OF RANGE FOR DEVICE ddd 
Ending sector address range is as Reprompts. 
follows: 


DISKETTE 000-074 0-1 1-26 
DISK 000-302 0-1 0-59 






ENDING SECTOR OCCURS BEFORE STARTING SECTOR FOR DEVICE ddd 


Ending sector address on disk or 
diskette occurs before starting 
sector address. 


Reprompts. 


DEFAULT WORKSPACES (ccchss,ccchss) 

The text editor, assembler, and None. 
linkage editor require workspaces. 

The operator has the option of 

accepting the location and size 

of the default workspaces or 

specifying his own workspaces. 


INVALID RESPONSE - MUST BE YES OR NO. 
The response to the prompt must 
be either YES or NO. 


Reprompts. 


WORKSPACES1 AND 2 OVERLAP 
WORKSPACES! and 2 were allocated 
the same or a portion of the same 
workspaces. 


Reprompts. 


WORKSPACES1 AND 3 OVERLAP 
WORKSPACES1 and 3 were allocated 
the same or a portion of the same 
workspaces. 


Reprompts. 


WORKSPACES2 AND 3 OVERLAP 
WORKSPACES? and 3 were allocated 
the same or a portion of the same 
workspaces. 


Reprompts. 


DEVICE NOT ATTACHED AT ADDRESS ddd 
The device at the specified device 

address is not attached to the 

system. An error in the response 

is assumed. 


Reprompts. 


DEVICE NOT READY AT ADDRESS ddd 
The device at the specified 

device address is not in the 

ready state. 


has been readied. 


END OF FORMS ON PRINTER 
The printer is out of paper. 
has been adjusted. 


Waits until the device 


Waits until the printer 


Your Action 


Reenter the response. 


Reenter the response. 


Respond to this prompt with 
either YES or NO. YES designates 
that the default workspaces are 

to be used. NO designates that 

the operator will specify his own 
workspaces, If the response is NO, 
the processing program will 
prompt for required workspaces. 


Respond to the prompt with 
either YES or NO. 


Allocate separate workspaces 
for WORKSPACES! and 2 and 
reenter the response. 


Allocate separate workspaces 
for WORKSPACESI and 3 and 
reenter the response. 


Allocate separate workspaces 
for WORKSPACES? and 3 and 
reenter the response. 


Reenter the response. 


Ready the appropriate device 
and generate an interrupt 
(hit any key) at the operator 
console. 


Add paper to the printer and 
ready the device. 
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id033A 


id034A 


id035A 


id036A 


id099I 


Message and Explanation 
PRINTER IN WAIT STATE 

The printer has been put in 

the wait state (hardware switch), 


System Action 


Waits until the printer 
has been readied. 


DISKETTE REMOVED PRIOR TO I/O COMPLETION AT ADDRESS ddd 
The diskette was removed while the Waits until the removed 
processing program was addressing it. diskette is returned. 


INVALID VOL1 DISKETTE LABEL ON DEVICE ddd 
The VOL1 label (sector 000007) Waits until the VOL1 has 
is invalid. been corrected. 


REPLY TO WHEN THE DEVICE IS READY 
This message is printed after the 
following action messages: 


Waits for operator reply. 


e id031A 
e id032A 
e id033A 
e id034A 
e id035A 


and is reissued if GO is not 
entered properly. 


LAST SECTOR WRITTEN = ccchss 

Each processing program that None. 
creates or moves data into a user 

data file identifies the sector 

address of the last sector 

written. 
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Your Action 


Ready the printer. 


Return the diskette to the drive, 


Initialize the diskette or correct 
the VOL1 according to the fields 
defined in The IBM Diskette for 
Standard Data Interchange, Order 
Number GA21-9182-0. 


Rebuild the system. If the 
problem still persists, submit 

a Authroized Program Analysis 
Report (APAR) as outlined in the 
Program Logic Manual. 


None. 


UNRECOVERABLE I/O AND SYSTEM MESSAGES 


id900T 


Message and Explanation System Action 
UNRECOVERABLE I/O ERROR: 

DEVICE = ddd 

ERROR CODE = nnnn 

10 CC=nINTCC=n 


ISB = nnnn 

DEVICE ID = nnnn 

IDCB = nnnn nnnn 

CSSW = nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 

DCB1 = nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 

DCB2 = nnnn nnnn nnnn nannn nnnn nnnn nnnn nnnn 
SECTOR = ccchss 

An unrecoverable I/O error has Program abnormally 
occurred on the specified device. terminates. 


The error code describes the type 

of error which occurred last in 

the sequence of error recovery retries. 
Values for the error code: 

X‘0412’ - Device busy 

X‘0413° - Control address marker present 
X‘0414’ - Parity error 

X‘0415’ - Intervention required 

X‘0416° - Controller busy 

X‘0417’ - Invalid interrupt 

X‘0418? - Printer error 

X‘0419” - Printer error 

X‘041A’ - No record found 

X‘041B’ - Track overflow 

X‘041C’ - Invalid surface side specified 
X‘041E’ - Command reject 

X‘041F’ - Protect check 

X‘0420° - Address specification error, DCB specified error 
X‘0421’ - Invalid storage address 
X‘0422’ - Invalid IO command 

X‘040F’ - Unrecoverable error; check IO CC, INT CC, ISB, and CSSW for error shaves 


The IO CC is the IO machine 
instruction code set by the 
last executed IO instruction 
to the device. 


The IDCB field displays the 
operand of that I/O instruction. 
The INT CC is the condition code 
presented by the last interrupt 
from the device, and the ISB is the 
interrupt status byte associated 
with the interrupt. The DEVICE ID 
field identifies the device and 

must be considered when analyzing 
the ISB and IDCB field as described 
by the specified devices attachment 
hardware description. 


GA34-0023 IBM 4221 Diskette Unit 
Description 

GA34-0024 IBM 4211 Disk Storage 
Unit Description 

GA34-0025 IBM 0241 Printer 
Description 

GA34-0022 IBM 4011 Processor & 
Processor Feature Description 
GA34-0021 IBM 4021 Processor & 
Processor Feature Description 


Your Action 


Rebuild the system. If the problem 
still persists, submit a Authorized 
Program Analysis Report (APAR) as 
outlined in the Program Logic Manual. 
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id901T 
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Message and Explanation System Action 


The following is a brief procedure 
for error analysis: 


For cycle stealing devices, 
interrogate the information in the 
following steps: 

e Check for IO CC errors 

e If IO CC indicates success then 
check for INT CC errors 

e If INT CC exception condition, 
then check ISB for errors 

e If cycle steal status is 

available (as indicated by 

the ISB), then error status 

bits are set by the CSSW 

(cycle steal status words). 


Note. For non-cycle steal status 

available errors, the IDCB points 

to DCB1 which is the last DCB issued 

to the device. The contents of DCB1 

are related to the type of command 

field and modifier in the IDCB. DCB2 
contains the READ/WRITE DCB last issued 
to the device. If the chain bit is on 

in DCB1, then DCB2 is chained to DCB1. 
For disk and diskette devices, SECTOR 
specifies the ccchss of the last 

sector attempted to be accessed if 

DCB2 contains a READ/WRITE command 
field. 


IOCS CALLER ERROR 

ERROR CODE = nnnn 

IOCB ADDRESS = nnnn 

IOCB = nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 


A system error has been detected. Same as id900T. 


Possible error codes: 

X‘1001’ - Invalid DDD pointer in IOCB 

X‘1002’ - Previously connected IOCB 

X‘*1003’ - Un-CONNECTed IOCB (DCONNECT) 
X‘2004’ - CONNECT race detected 

X‘2005° - Invalid IOCB-DDB physical record size 
X‘2008’ - Invalid internal CONNECT parameter 
X‘2009” - Invalid DDB physical record size 
X‘100A’ - Invalid IOCB-DDB device ID 

X‘1101’ - Invalid buffer address 

X‘1102’ - Un-CONNECTed IOCB (READ/WRITE) 
X‘1103 - Invalid IOCB on DDB-IOCB chain 
X‘1104’ - Invalid IOCB self-pointer 

X‘1105’ - Invalid IOCB-DDB pointer on DDB-IOCB chain 
X‘1106’ - Invalid IOCB-DDB CONNECT status 
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Your Action 


If the device is a disk or diskette 
and the error is determined 
to be no record found, assign 


_ the area designated by SECTOR an 


alternate location using the 
Disk/Diskette Initialization utility. 
If the error condition persists, the 
hardware device should be serviced. 


id902T 


id9501 


id951T 


id9521 


id953T 


id9541 


id955I 


Message and Explanation 


IOCB INVALID 

ERROR CODE = nnnn 

IOCB ADDRESS = nnnn 

IOCB = nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nonn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nonn 
nnnn nnnn nnnn nnnn nnnn nnnn nnnn nnnn 


System Action 


An error code other than those Same as id900T. 
listed in id900T and id901T is 

present. 

UNDETERMINABLE CHECK 

PSW SAR IAR LSR 

XXXX XXXKX XXXKX XXXX 

REGO REG1 REG2 REG3 REG4 REGS REG6 
XXXX XXXX XXXX XXXX XXXX XXXX XXKX 


An exception has occurred but the 
cause cannot be determined. 


PROGRAM CHECK 

PSW SAR IAR LSR 

XXXX XXXX XXXX XXXX 

REGO REGI1 REG2 REG3 REG4 REGS  REG6 
XXXX XXXX XXXX XXXX XXXX XXXX XXXX 
A program check has occurred at Same as id900T. 
location of IAR. 

MACHINE CHECK 

PSW SAR IAR LSR 

XXXX XXXX XXXX XXXX 

REGO REGIL REG2 REG3 REG4 REGS ~  REG6 
XXXX XXXX XXXX XXXX XXXX XXXX XXXX 
A machine check has occurred. Same as id900T. 
INVALID SVC 

PSW SAR IAR LSR 

XXXX XXXX XXXX XXXX 

REGO REGI REG2 REG3 REG4 REGS ~  REG6 
XXXX XXXX XXXX XXXX XXXX XXXX XXXX 
A supervisor call has been made. Same as id900T. 
No SVCs are supported. 

POWER THERMAL WARNING 

PSW SAR IAR LSR 

XXXX XXXX XXXX XXXX 

REGO REGI REG2 REG3 REG4 REGS  REG6 
XXXX XXXX XXXX XXXX XXXX XXXX XXXX 
Power and/or thermal warning Same as id950I. 
has occurred. 

INVALID TRACT REQ 

PSW SAR IAR LSR 

XXXX XXXX XxxX XXXX 

REGO REG! Reg2 REG3 REG4 REGS REG6 
XXXX XXXX XXXX XXXX XXXX XXXX XXXX 
A trace request has been made. Same as id95OI. 


No trace requests are supported. 


REG7 
XXXX 


Continues processing. 


REG7 
XXXX 


REG7 
XXXX 


REG7 
XXXX 


REG7 
XXXX 


REG7 
XXXX 


Your Action 


Same as id900T. 


Same as id901T. 


Same as id900T. 


Same as id900T. 


Same as id900T. 


Same as id900T. 


Same as id901T. 
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id9561 


id990T 


id999I 


Message and Explanation 


INVALID CONSOLE INTR 

PSW SAR IAR LSR 

XXXX XXXX XXXX XXXX 

REGO REGi REG2 REG3  REG4 
XXXX XXXX XXXX XXXX XXXX 


A console interrupt has been made. 
The console interrupt function is 
not supported. 


EXECUTION HALTED 
This message is printed after the 
following messages: 


© id951T 
0id952T 
e 1d953T 


FUNCTION TERMINATED 


System Action 


REGS  REG6 
XXXX XXXX 


Same as id950I. 


Same as id900T. 


REGS xxxx XXXX XXXX XXXX XXXK XXXX XXXX XXXX 


This message is printed by the 
processing program upon detection 
of a terminal error and indicates 
abnormal termination. REGS 
displays the register contents at 
termination time. 
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Same as id900T. 


REG7 
XXXX 


Your Action 


Same as id901T. 


Enter GO (CR) when the requested 
action from the previous action 
message has been taken. 


If a full function console is 
present, do not depress CONSOLE 
INTERRUPT during processing. If 
a full function console is not 
present, same as id901T. 


CH—CREATE DISKETTE HDR1 MESSAGES 


CH110A 


CH120A 


CH130A 


CH140A 


CH146E 


CH200E 


CH21S5E 


CH230E 


CH240E 


CH250E 


CH260E 


Message and Explanation 
DEVICE ADDRESS= 

A prompt requesting the diskette 
device address. 


System Action 


Waits for input. 


HEADER NAME= 

A prompt requesting the name of 
the data file described by the 
HDR1 record. 


Waits for input, 


EXTENTS= 

A prompt requesting the starting 
and the ending sector addresses of 
the data file to be defined by this 
HDR1 record. 


Waits for input. 


END OF DATA= 
A prompt requesting the address, 
within the data file, that contains 
the last data item. 


Waits for input. 


EXCHANGE DATA AREAS MUST LIE ON CYLINDERS 1 THRU 73 
Cylinders 0 and 74 are reserved on Reprompts. 
basic exchange diskettes. 


END OF DATA NOT WITHIN EXTENTS 
The ccchss given for the end of file 

is greater than the end of extent 

ccchss or less than the beginning 

of extent ccchss, 


Reissues prompt for the 
end of file ccchss, 


EXTENTS NOT COMPARIBLE WITH EXISTING HDR1 


The proposed data set overlaps Reprompts. 
an existing data set and can 

not be built. 

ALL. HDR1’s IN USE - UNABLE TO CREATE 

All 19 HDR1’s on this diskette are Reprompts. 


in use. 


EXTENT ARRANGEMENT INDICATOR NOT COMPATIBLE 
The extent arrangement indicator in the Reprompts. 
VOLID was P a flag indicating that the 

extents must be adjacent and that all 

unallocated space must follow the last 

data set extent on the volume, and 

creation of this data set would cause 

either the data sets to not be in ccchss 

order or not all of the free space to be 

at the end, 


DUPLICATE NAME ON VOLUME 
Header name given matches the 
HDR1 name already on the diskette. 


Reprompts. 


UNABLE TO READ HDRI1 

Invalid extents (BOE or EOE) on the 
HDR1 were read from the diskette 
or an unrecoverable I/O error on 

the HDRI1 was read. 


Reprompts. 


Your Action 


Enter a 3-character device 
address in ddd format. 


Enter a 1- to 8-character 
alphameric name in cccccccc format. 


Enter the starting and ending 
sector addresses in ccchss,ccchss 
format. 


Enter the address in ccchss format. 


Reenter the exchange data areas 
on cylinders 1 thru 73. 


Reenter the valid end of file. 


Look at HDR1’s on the diskette 
and pick the beginning and ending 
extents to avoid conflict. 


Delete a data set to recover 
a HDRI or get a diskette with 
free HDR1’s. 


Set up the beginning ccchss to 
follow directly after the last 
contiguous data set on the volume. 


Pick a new data set name and 
restart the program. 


Check the HDR1’s, If they are all 
valid, retry. If the message persists, 
copy to a new diskette and retry. 
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| CH299T 


CH401E 


CH402E 


CH405E 


CH406E 


Message and Explanation 
CREATE HDR1 CYCLE ERROR END 


The program is recycled. 


INPUT MESSAGE TOO LONG 
All expected fields were found 
before the end of the input message. 


FIELD TOO LONG OR DELIMITER ERROR 
Too many characters were detected 

prior to a comma or blank field 

delimiter. 


INPUT NAME IS INVALID 
An illegal character or a null name 
was entered in the name field. 


INVALID CHARACTER IN INPUT FIELD 
Conversion returned the invalid 

character code. A non-decimal 

digit was entered in the converted 

field. 
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System Action 


The program terminates. 


Reprompts. 


Reprompts. 


Reprompts. 


Reprompts. 


Your Action 


None. 


Check for an extra field, wrong 
input type, misplaced comma or too 
many characters in the last field. 
Reenter the corrected data. 


Correct and reenter the input. 


Correct and reenter the input. 


Correct and reenter the input. 


DH—DELETE DISKETTE HDR1 MESSAGES 


Message and Explanation 
DH110A DEVICE ADDRESS= 

A prompt requesting the diskette 

device address. 


DH120A HEADER NAME= 
A prompt requesting the name of 
the HDR1 record to be deleted. 


System Action 


Waits for input. 


Waits for input. 


DH240E EXTENT ARRANGEMENT INDICATOR NOT COMPATIBLE 


Extent arrangement indicator (EAI) is 
P a flag indicating that the extents must 
be adjacent and that all unallocated 
space must follow the last data set 
extent on the volume, and the data set 
to be deleted is not the last physical. 
HDR1 on the diskette, Only the last 
may be deleted, 


DH2S50E HDR1 NAME NOT FOUND 
Data file name supplied is not 
on the diskette, 


DH260E UNABLE TO READ HDR1 
Invalid extents (BOE or EOE) 
on the HDR1 were read from the 
diskette or an unrecoverable I/O 
error on the HDR1 was read. 


DH299T DELETE HDR1 CYCLE ERROR END 
The program is recycled. 


DH401E INPUT MESSAGE TOO LONG 
All expected fields were found 
before the end of the input message. 


DH402E FIELD TOO LONG OR DELIMITER ERROR 
Too many characters were detected 
prior to a comma or blank field 
delimiter. 


DH405E INPUT NAME IS INVALID 
An illegal character or a null name 
was entered in the name field. 


DH406E INVALID CHARACTER IN INPUT FIELD 
Conversion returned the invalid 
character code. A non-decimal 
digit was entered in the converted 
field. 


Reprompts. 


Reprompts, 


Reprompts. 


The program terminates. 


Reprompts. 


Reprompts. 


Reprompts. 


Reprompts. 


Your Action 


Enter a 3-character device address 
in ddd format. 


Enter a 1- to 8-character 
alphameric name in cccccccc format. 


Delete all following HDR1’s 
first. 


Get the correct data file name 
and restart the program. 


Check the HDR1’s. If they are all 
valid, retry. If the message persists, 
copy to a new diskette and retry. 


None. 


Check for an extra field, wrong 
input type, misplaced comma or 
too many characters in the last 
field, Reenter the corrected data. 


Correct and reenter the input, 


Correct and reenter the input, 


Correct and reenter the input. 


Messages M-11 


FD—DISK TO PRINTER DUMP MESSAGES 


Message and Explanation System Action Your Action 
FDIOOA DISK AREA= 
A prompt requesting the location None. Enter the location of the data 


of the data file to be dumped. file in ddd,ccchss,ccchss format. 


FD2021 DISK TO PRINTER DUMP CYCLE ABNORMALLY TERMINATED . 
The dump cycle has been terminated. Reprompts. Reenter the response. 
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FI—DISK INITIALIZATION MESSAGES 


FIO03I 


FIO041 


FI110A 


FI120A 


FI121E 


FI130A 


FI140I 


FI141T 


FI142W 


FI143W 


FILSOA 


FIIS1A 


Message and Explanation 


PRIMARY INITIALIZATION MODE 
This mode was chosen and the 
given disk is to be reinitialized. 


ALTERNATE SECTOR MODE 
This mode was chosen and an 
alternate is to be assigned to 
the specified sector. 


DEVICE ADDRESS= 
A prompt requesting the disk device 
address. 


TYPE= 
A prompt requesting the type of 
initialization to be performed. 


INVALID TYPE - MUST BE PI OR AS 
An incorrect initialization type 

has been entered in the response 

to TYPE= prompt. 


SECTOR ADDRESS= 

A prompt requesting the sector 
address of the defective sector 
for alternate assignment. 


ALTERNATE SECTOR ASSIGNED FOR ccchss 


An alternate sector is assigned 
for defective sector ccchss. 


ALTERNATE SECTOR ALREADY ASSIGNED 


An alternate sector has already 
been assigned. 


Alternate sector assignment is 
unable to mark the alternate 
for ccchss as defective, but a 
new alternate has been assigned. 


DATA RECOVERY FAILED 
Data from the bad sector has not 
been recovered. 


ARE DEFECTIVE SECTOR FLAGS INVALID 


A prompt requesting whether the 
defective flags are invalid. 


System Action 


None. 


None. 


Waits for the input. 


Waits for the input. 


Reprompts for initialization 


type via the TYPE= prompt. 


Waits for input. 


None. 


Program terminates. 


- UNABLE TO MARK DEFECTIVE ALTERNATE FOR CCCHSS = ccchss 


None. 


None. 


Waits for input. 


REPLY TO DEFECTIVE FLAG PROMPT MUST BE YES OR NO 


Reply to the defective flag prompt 
must be YES or No. Any other 
response is invalid. 


Reprompts. 


Your Action 


None. 


None. 


Enter a 3-character device 
address in ddd format. 


Enter either PI for primary 
initialization or AS for 
alternate sector assignment. 


Respond to the prompt with PI for 
primary initialization or AS 
to assign an alternate sector. 


Enter the sector address of the 
defective sector in ccchss format. 


None. 


Program error. Retry with a rebuilt 
system. If error persists, then 
perform software maintenance. 


Avoid use of the sector ccchss 
because data loss may occur. 


Data from the sector reassigned 
is lost. 


Enter either YES or NO. YES allows 
a disk with invalid sector flags to 
be processed. 


Note. Reply YES only if the disk 
cannot be initialized; otherwise, 
enter NO unless the defective 
sector flags have been destroyed. 


Reenter the response to the invalid 
sector flag prompt as either 
YES or NO. 
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FI200T 


FI210W 


FI220W 


FI230T 


FI240T 


FI401E 


Message and Explanation System Action 
ALTERNATE SECTORS NOT ASSIGNED FOR CYLINDER 1 

An attempt was made to assign an Program terminates. 
alternate to a sector on cylinder 

1. Cylinder 1 is reserved 


_to contain only alternate 
- sectors. 


SECTOR ccchss ON CYLINDER 1 HAS BEEN MARKED DEFECTIVE 
The noted ‘sector on the None. 

alternate cylinder has been 

marked as defective and cannot 

be used in alternate sector 

assignment. 


UNABLE TO MARK SECTOR AT ccchss AS DEFECTIVE 
Disk Initialization has determined None. 
that ccchss is defective, but it 

has been unable to mark it as 

such. An alternate has been assigned. 

If the error on sector ccchss is 

intermittent, this could cause the 

original damaged sector to be 

referenced in subsequent I/O 

operations. ccchss is the cylinder, 

head, sector address of the sector 

referenced. 


UNABLE TO ASSIGN ALTERNATE SECTOR - ALTERNATE CYLINDER FULL 


Alternate sector assignment has Program terminates. 
been requested, but an alternate 
can not be assigned, because there 


are no free alternates to use. 


UNABLE TO INITIALIZE - TOO MANY BAD SECTORS 

Primary initialization has been Program terminates. 
attempted and more than 120 

bad sectors have been found. 


INPUT MESSAGE TOO LONG 
All expected fields were found 
before the end of the input 
message. 


Reprompts. 
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Your Action 


If the intent is to assign an 
alternate to a bad alternate 
sector, the ccchss of the 
original bad sector should be 

used in requesting the alternate 
sector assignment. Any unassigned 
bad sector on cylinder 1 should 
be marked as defective and 
ignored. 


The number of such messages 
during an initialization should 

be logged. This number added to 
the number of alternates assigned 
tells the number of sectors used 
on Cyl 1. This keeps track of 

the available alternates. 


None. 


Since an alternate can not be 
assigned on the alternate 

cylinder, the user must either 
avoid the bad sector or program 
an error recovery for this case. 
The condition should be reported, 
because the normal error 

recovery route is now blocked-and 
the disk can probably not be 
initialized. In which case the 
entire disk should be considered 
defective. 


The disk file is unusable. 


Check for an extra field, wrong 
input type, misplaced comma or too 
many characters in the last field. 
Reenter the corrected data. 


FI402E 


FI405E 


FI406E 


Message and Explanation 


FIELD TOO LONG OR DELIMITER ERROR 
Too many characters were detected 

prior to a comma or blank field 

delimiter. 


INPUT NAME IS INVALID 
An illegal character or null name 
was entered in the name field. 


INVALID CHARACTER IN INPUT FIELD 
Conversion returned the invalid 

character code. A non-decimal digit 

was entered in the converted field. 


System Action 


Reprompts. 


Reprompts. 


Reprompts. 


Your Action 


Correct and reenter the input. 


Correct and reenter the input. 


Correct and reenter the input. 


Messages 
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FR—DISK TO DISKETTE COPY MESSAGES 


FRIO0A 


FR102E 


FR200A 


FR420E 


Message and Explanation System Action 
FROM DATA AREA= 
A prompt requesting the source data None. 


file information. 


DISK TO DISKETTE COPY CYCLE ABNORMALLY TERMINATED 
The copy cycle has been terminated Reprompts. 
without completion. 


TO DATA AREA= 
A prompt requesting the destination None. 
data file information. 


INVALID DESTINATION DATA FILE - INSUFFICIENT SIZE 
The destination data file is too Reprompts. 
small to hold the copy of the 

source data file. 
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Your Action 


Enter the source data file 
information in ddd,ccchss,ccchss 
format. 


Reenter the response. 


Enter the destination data file 
information in ddd,ccchss,ccchss 
format. 


Reenter the response. 


IP—BOOTSTRAP/LOADER DISK MESSAGES 


IP100A 


IP200E 


IP210E 


IP220E 


IP230E 


Message and Explanation 


EXEC= 

The loader prompts for the name 
or the starting sector address of 
the program to be executed. 


PROGRAM TOO LARGE FOR STORAGE 


$IPTLODR determined that the 
requested program to be loaded 
will not fit in the available 
storage. 


INVALID PROGRAM HEADER 
The header at the location that 
the operator requested was invalid. 


PROGRAM NOT FOUND 
The requested program to be loaded 
was not on the disk. 


STARTING SECTOR ADDRESS INVALID 


The ccchss value is either out of 
range for the device or a non- 
numeric value is used. 


System Action 


Waits for the input from 
the operator station. 


Reprompts for the next 
request, 


Issues another prompt to 
the operator. 


Reprompts for the next 
tequest. 


Reprompts. 


IP—BOOTSTRAP/LOADER DISK WAIT CODES 


X‘610E’ 
X‘610F’ 
X'61C0C 
X‘61DD’ 


X‘61BB’ 
X*61BC 
X*61AA’ 
X°61 AB’ 
X‘61CD’ 
X‘6188’ 
X°6120° 
X‘61 FF’ 
X°6199° 


Wait Code and Explanation 


Machine check, 

Program check. 

1/O error preparing printer. 

I/O error preparing operator 
station. 

1/O error printer. 

1/O error operator station (write). 
I/O error operator station (read), 
1/O error disk, start. 

1/O error disk, end of track. 

No ISB (instruction status block) stored. 
No record found. 
Loader error. 

Unrecoverable I/O error. 


System Action 


Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 


Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 


Your Action 


Enter a 2-character IBM supplied 
ID or the ccchss of the program. 


- Request another program 


to be loaded. 


Determine if the location on 
the disk for the program is 
correct and reenter. 


Request another program to be 
loaded. 


Determine the correct value 
and reenter. 


Your Action 


None. 
None. 
None. 
None. 


None. 
None, 
None. 
None, 
None. — 
None. 
None. 
None. 
None. 


. Messages 
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P1—STORAGE TO PRINTER DUMP WAIT CODES 


X61 EE’ 
X‘610F’ 
X‘610E 
X‘6106 


X‘61AB’ . 


X°6120° 
X‘6199" 
X‘6188’ 
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Wait Code and Explanation 


Too many alternate cylinders. 
Program check. 

Machine check. 

End of diskette. 

1/O error disk, start. 

No record found. 
Unrecoverable I/O error. 


No ISB (instruction status block) stored. 
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System Action 


Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 


Your Action 
None. 
None. 
None. 


- None. 


None. 
None. 
None. 
None. 


RD—DISKETTE TO PRINTER DUMP MESSAGES 


| RD100A 


RD202I1 


Message and Explanation System Action 
DISKETTE AREA= 
A prompt requesting the location None. 


of the data file to be dumped. 


DISKETTE TO PRINTER DUMP CYCLE ABNORMALLY TERMINATED 
The dump cycle has been terminated. Reprompts. 


Your Action 


Enter the location of the data 
file in ddd,ccchss,ccchss format. 


Reenter the response. 


Messages 
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RF—DISKETTE TO DISK COPY MESSAGES 


RF100A 


RF102E 


RF200A 


RF420E 


Message and Explanation System Action 
FROM DATA AREA= 
A prompt requesting the source data None, 


file information. 


DISKETTE TO DISK COPY CYCLE ABNORMALLY TERMINATED 
The copy cycle has been terminated Reprompts. 
without completion. 


TO DATA AREA= 
A prompt requesting the destination None. 
data file information. 


INVALID DESTINATION DATA FILE - INSUFFICIENT SIZE 
The destination data fileistoo Reprompts. 
small to hold the copy of the 

source data file. 
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Your Action 


Enter the source data file 
information in ddd,ccchss,ccchss 
format. 


Reenter the response. 


Enter the destination data file 
information in ddd,ccchss,ccchss 
format. 


Reenter the response. 


RI—DISKETTE INITIALIZATION MESSAGES 


RII10A 


RI120A 


RI1251 


RI127A 


RI129A 


RI1331 


RI1L351 


RI1401 


RI200T 


RI202T 


‘ROS! 


RI1371 


Message and Explanation System Action 


DEVICE ADDRESS= 

A prompt requesting the device None. 
address of the diskette to be 

initialized, 


NEW VOLID= 
A prompt requesting the VOLID to None. 
be written to the diskette. 


CURRENT VOLID = ccccce 
An informational message which None. 
supplies the CURRENT VOLID. 


DO YOU WANT TO INITIALIZE THIS DISKETTE? RESPOND YES OR NO. 


A prompt which is issued when the None 
supplied NEW VOLID is different from 

the existing CURRENT VOLID on the 

diskette. 


INVALID RESPONSE - MUST BE YES OR NO 
An invalid response has been 

entered for the prompt from 

message RI127A. 


Reprompts. 


INVALID VOL! LABEL 
The diskette has a VOLI label which None. 
is either not standard or destroyed. 


VOLID IS BLANK 

The VOLID of the VOL1 label is None. 
blank. 
DEFECTIVE CYLINDER cch. 

An informational message which is None. 


issued for each defective cylinder. 
ce is the decimal number of the 
defective cylinder and h is the 
decimal number of the head. 


UNABLE TO INITIALIZE - TOO MANY DEFECTIVE CYLINDERS 
Two cylinders on a diskette Program terminates. 
may be formatted as bad. If 

more exist, the diskette is 

considered defective. 


UNABLE TO INITIALIZE - DEFECTIVE DISKETTE 

Either cylinder 0 is bad or the Program terminates. 
utility is unable to format a 

cylinder as defective because the 

entire cylinder is bad. 


DISKETTE INITIALIZATION ABNORMALLY TERMINATED 
This message is issued when a Reprompts. 
reply of NO is entered for the 
message RI127A. 


CYLINDER 0 IS UNFORMATTED 
Cylinder 0 has either never been formatted None. 
or has been destroyed. 


Your Action 


Enter a 3-character device 
address in ddd format. 


Enter a 1- to 6-character 


alphameric name in cccccc format. 


None. 


Enter YES or NO. 


Enter YES or NO. 


None. 


None. 


None. 


Get a new diskette. Old one 
is defective. 


Get a new diskette. Old one is 
defective. 


Change the diskette or terminate 
the program. 


None. 
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RI401E 


RI402E 


RI405E 


RI406E 


Message and Explanation 
INPUT MESSAGE TOO LONG 
All expected fields were found 
before the end of the input 
message. 


FIELD TOO LONG OR DELIMITER ERROR 
Too many characters were 

detected prior to a comma or 

blank field delimiter. 


INPUT NAME IS INVALID 
An illegal character or null name 
is entered in the name field. 


INVALID CHARACTER IN INPUT FIELD 
Conversion returned the invalid 

character code. A non-decimal 

digit is entered in the converted 

field. 
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System Action 


Reprompts. 


Reprompts. 


Reprompts. 


Reprompts. 


Your Action 


Check for an extra field, wrong 
input type or too many characters 
in the field. Reenter the corrected 
data. 


Correct and reenter the input. 


Correct and reenter the input. 


Correct and reenter the input. 


SB—AUTOMATIC SYSTEM BUILD 


SB200E 


SB210T 


SB220E 


SB240T 


SB300E 


SB400E 


Message and Explanation 

HDR1 NOT FOUND 

The HDR1 supplied is not on the 
diskette. 


INVALID PROG HEADER 
There is an invalid header at 
the location read by the loader. 


PROG NOT FOUND 
The Automatic System Build 
program is not found. 


PROG TOO LARGE FOR STORAGE 
$SBLOADR determined that the 
Automatic System Build program 

will not fit in storage. 


UNABLE TO READ VOL1 AND/OR HDR1 
The Automatic System Build program 

is unable to read the VOL1 and/or 

the HDR1. 


DISKETTE VOLID = nnnnnn NOT COPIED 
The diskette VOLID is not copied. 


System Action 


Program terminates. 


Program terminates. 


Program terminates. 


Program terminates. 


Program terminates. 


Program terminates. 


Your Action 


Check diskette HDR1’s and make 
sure that the required files have 
HDR1’s. Correct HDR1’s and reload 
the diskette. 


Check the PID diskettes HDR1s 
and ensure that the required 
files have valid headers. 


Check the Automatic System Build 
program (ID=SB) which resides at 
diskette address ccchss=002001. 
Correct the program and rerun. 


Check the size field in the HDR1 
for ID=SB and ensure that it has 
not been modified. Correct the 
program and rerun. 


The diskette is not properly formatted. 
Correct the format and reload the 
diskette. 


An unrecoverable I/O error has 
occurred. The I/O should output 
the cause of the error. Correct 
the program and rerun. 
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SF—SYSTEM VERIFICATION MESSAGES 


Message and Explanation System Action Your Action 

SF400E = INVALID HEADER ON DISK 
‘The header was encountered Program terminates. Check the header ID for the 
with an invalid header ID. header record. 


SFS00E module name NOT ON DISK 


The module whose name appears in Program terminates. Determine why the module was 
the message text was not found not located on the disk. _ 
on the disk system. 

SF600E module name NOT IN SYSTEM TABLE 
The module whose name appears in None. Check the program name for the — 
the message text was not found header record. 


in the system table. 


SF700E INVALID HEADER CHAIN 


The header for the end of the Program terminates. Check the location of the headers 
PP modules was encountered for the end of the SCP modules and 
before the header for the SCP the end of the PP modules. 


modules on the disk. 
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S1—STORAGE TO DISKETTE DUMP WAIT CODES 


X‘61EE’ 
X‘610F” 
X‘610E” 
X*6106’ 
X*61AB’ 
X°6120° 
X*6199” 
X‘6188" 


Wait Code and Explanation 


To many alternate cylinders. 

Program check. 

Machine check. 

End of diskette. 

1/O error disk, start. 

No record found. 

Unrecoverable I/O error. 

No ISB (instruction status block) stored. 


System Action 


Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 
Program terminates. 


Your Action 


None. 
None. 
None. 
None. 
None. 
None. 
None. 
None. 


Messages 
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TF—DISK PATCH MESSAGES 


TF100E 


TF101E 


TF102E 


TF104E 


TF1OSE 


TF106E 


Message and Explanation System Action 
INVALID DISPLACEMENT - NON-DECIMAL DIGIT 
The byte displacement into the Reprompts. 


sector is not a decimal digit. 

The byte displacement is the 31rd 
parm used to describe the patch 
location in response to PATCH 
AREA=ddd,ccchss,bbb,nnn. The 
byte displacement (bbb) must be 
3 decimal digits. 


INVALID DISPLACEMENT - 3 DIGITS REQUIRED 

The byte displacement into the Reprompts. 
sector is not 3 decimal 

digits. The byte displacement 

is the 3rd parm used to describe 

the patch location in response 

to PATCH AREA=ddd,ccchss,bbb,nnn. _ 

The byte displacement (bbb) must be 

3 decimal digits. 


INCORRECT NUMBER OF PARAMETERS - 4 REQUIRED 
The expected number of parameters Reprompts. 
was not received. The response to 

the prompt message PATCH AREA= must 

be of the form ddd,ccchss,bbb,nnn. 


INVALID BYTE COUNT - NON-DECIMAL DIGIT 

The number of bytes to display Reprompts. 
for verification is not a decimal 

digit. The byte verification count 

(nnn) must be 3 decimal digits. 


INVALID BYTE COUNT - 3 DIGITS REQUIRED 

The number of bytes to display for Reprompts. 
verification is not 3 decimal 

digits, The byte verification 

count (nnn) must be 3 decimal digits 

greater than 0 but less than 257. 


PATCH EXCEEDS SECTOR BOUNDARY 

When either the number of bytes Reprompts. 
to display for verification or 

the actual patch data is added to 

the byte displacement, the result 

is greater than 256. The data would 

be beyond the extent in bytes of 

the sector within which the 

patch should be applied. 
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Your Action 


Reenter the patch data with the 


correct byte displacement. 


Reenter the patch data with the 
correct byte displacement. 


Reenter the patch data with the 
correct number of parameters. 


Reenter the patch data with the byte 
verification count in decimal. 


Reenter the patch data with 3 
decimal digits. 


Reenter the patch data with the 
corrections. 


Message and Explanation System Action Your Action 
TFIO7E INVALID HEX DATA 
The replacement data for the Reprompts. Reenter the patch data from the 
patch was not entered in the form beginning of the patch session. 
hhhh hhhh ..., where hhhh is a 
2-byte hexadecimal group of data. 


TF200A PATCH AREA= 


A prompt requesting the location on None. Enter the requested information in 

the disk to be patched. ddd,ccchss,bbb,nnn format. 
TF201A REPLACEMENT DATA= 

A prompt requesting the replacement None, Enter either groups of four 

data to be patched. hexadecimal characters, separated 


by blanks in hhhh hhhh ... format, 
or if no patch is to be applied, 


enter NONE. 
TF202I! DISK PATCH CYCLE ABNORMALLY TERMINATED 
Error cycle end message appearing - Recycles and reprompts. Reenter the corrected response to 
after verify or replacement the prompt. 
functions are abnormally 
terminated. 
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TR—DISKETTE PATCH MESSAGES © 


TR1O0E 


TRIOLE 


TR102E 


TRIO4E 


TRIOSE 


TRI06E 


TRIO7E 


TR200A 


Message and Explanation System Action 


INVALID—NON-DECIMAL DIGIT 

The byte displacement into the Reprompts. 
sector is not a decimal digit. 

The byte displacement is the 3rd 

parm used to describe the patch 


. location in response to PATCH 


AREA#=ddd,ccchss,bbb,nnn, The byte 
displacement (bbb) must be 3 decimal 
digits, 


INVALID DISPLACEMENT - 3 DIGITS REQUIRED 

The byte displacement into the Reprompts. 
sector is not 3 decimal 

digits. The byte displacement is 

the 3rd parm used to describe the 

patch location in response to 

PATCH AREA=ddd,ccchss,bbb,nnn. 

The byte displacement (bbb) must be 

3 decimal digits. 


INCORRECT NUMBER OF PARAMETERS - 4 REQUIRED 
The expected number of parameters Reprompts. 
was not received. The response to the 

prompt message PATCH AREA= must be 

of the form ddd,ccchss,bbb,nnn. 


INVALID BYTE COUNT - NON DECIMAL DIGIT 

The number of bytes to display ; Reprompts. 
for verification is not a decimal 

digit. The byte verification count 

(nnn) must be 3 decimal digits. 


INVALID BYTE COUNT - 3 DIGITS REQUIRED 

The number of bytes to display Reprompts. 
for verification is not 3 decimal 

digits. The byte verification count 

(nnn) must be 3 decimal digits 

greater than 0 but less than 129. 


PATCH EXCEEDS SECTOR BOUNDARY 

When either the number of bytes — Reprompts. 
to display for verification or 

the actual patch data is added to 

the byte displacement, the result 

is greater than 128. The data 

would be beyond the extent in 

bytes of the sector within which 

the patch should be applied. 


INVALID HEX DATA 

The replacement data for the Reprompts. 
patch was not input in the form 

hhhh hhhh. .., where hhhh is a 

2-byte hexadecimal group of 

data. 


PATCH AREA= 
A prompt requesting the location on None. 
the diskette to be patched. 
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Your Action 


Reenter the patch data with the correct 


byte displacement. 


Issue error message. Start the patch 
processing loop again with the 
prompt message PATCH AREA=. 
Reenter the patch data with the 
correct byte displacement. 


Issue error message. Start the patch 
processing loop again with the 
prompt message PATCH AREA=. 
Reenter the patch data with the 
correct number of parameters. 


Reenter the patch data with the 
byte verification count in decimal. 


Reenter the patch data with 3 
decimal digits. 


Reenter the patch data with the 
corrections. 


Reenter the patch data. 


Enter the requested information in 
ddd ,ccchss,bbb,nnn format. 


Message and Explanation System Action Your Action 
TR201A REPLACEMENT DATA= 
A prompt requesting the replacement None. Enter either groups of four 
data to be patched. hexadecimal characters, separated 
by blanks in hhhh hhhh... format, 
or if no patch is to be applied, 


enter NONE. 
TR2021 DISKETTE PATCH CYCLE ABNORMALLY TERMINATED 
Error cycle end message appearing Recycles and reprompts. Reenter the corrected response to 
after verify or replacement the prompt. 


functions are abnormally terminated. 
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alternate sector assignment, disk 4-5 
automatic system build 2-1 


basic exchange format 44 
binary buffer 7-1, 7-2, 7-4, 7-8 
buffers 
binary 7-1, 7-2,7-4,7-8 
EBCDIC 7-1, 7-2, 7-4, 7-5 
CH (create diskette HDR1) 5-1 
configuration, minimum 1-2 
copy, disk to diskette (FR) 6-4 
copy, diskette to disk (RF) 6-1 
correcting errors at operator station 1-4 
create diskette HDR1 (CH) 5-1 
creating a diskette 
IPL bootstrap 3-1 
stand-alone storage to diskette dump 6-17 
stand-alone storage to printerdump 6-18 


data file, destination 6-1 
delete diskette HDR1 (DH) 5-5 
destination data file 6-1 
DH (delete diskette HDR1) 5-5 
disk initialization (FI) 

alternate sector assignment 4-5 

primary initialization 4-5 
disk IPL bootstrap/loader 3-2 
disk to diskette copy (FR) 6-4 
disk to printer dump (FD) 6-9 
diskette, create HDR1 (CH) 5-1 
diskette, delete HDR1 (DH) 5-5 
diskette initialization (RD) 4-1 
diskette IPL bootstrap 3-1 
diskette to disk copy (RF) 6-1 
diskette to printerdump (RD) 6-7 
diskette tracks, formatting 41 
dump, disk to printer (FD) 6-9 
dump, diskette to printer(RD) 6-7 
dump, storage to diskette (S1) 6-17 
dump, storage to printer (P1) 6-18 


EBCDIC buffer 7-1, 7-2, 7-4, 7-5 
EL €rror log) 7-1 
ERRMAP (error map) 4-1 
error correction at operator station 14 
error log program (EL) 7-1 
control block . 7-1 
error indicator 7-1, 7-3 
error map (ERRMAP) 4-1 


FD (disk to printer dump) 6-9 
FI (isk initialization) 4-5 
formatlogentry 7-1 
formatting diskette tracks 4-1 
FR (disk to diskette copy) 6-4 


Index 


hardware requirements for system 1-2 
HDR1 (header 1) 4-1 
HDR1 label format 4-2 


initial program load programs 
disk 3-2 
diskette 3-1 
initialization programs 
disk (FI) 4-5 
diskette (RI) 4-1 
IPL bootstrap, diskette 3-1 
IPL bootstrap/loader, disk 3-2 


loading a program 3-2 


operator station to disk patch (TF) 6-14 
operator station to diskette patch (TR) 6-11 


patch, disk (TF) 6-14 

patch, diskette (TR) 6-11 
primary initialization, disk 4-5 
program loading 3-2 

Pi (storage to printerdump) 6-18 


RD (diskette to printer dump) 6-7 
RF (diskette to disk copy) 6-1 
RI (diskette initialization) 4-1 


SF (system verification) 2-3 
storage to diskette dump (S1) 6-17 
storage to printer dump (P1) 6-18 
system build, automatic 2-1 
system hardware requirements 1-2 
system map 2-3, 2-4 

system verification (SF) 2-3 

S1 (storage to diskette dump) 6-17 


TF (disk patch) 6-14 
TR(iskette patch) 6-11 


utility programs, invoking 1-3 


verification, system (SF) 2-3 
VOLID (volume identification) 4-1 
volume identifier, diskette 2-2 
VOLI label format 4-1 


Index 
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YOUR COMMENTS, PLEASE... 


Your comments assist us in improving the usefulness of our publications; they are an 
important part of the input used in preparing updates to the publications. All comments 
and suggestions become the property of IBM. 


Please do not use this form for technical questions about the system or for requests 
for additional publications; this only delays the response. Instead, direct your 
inquiries or requests to your IBM representative or to the IBM branch office serving 
your locality. 


Corrections or clarifications needed: 


Page Comment 


What is your occupation?____. 
Number of latest Technical Newsletter (if any) concerning this publication: 
Please indicate your name and address in the space below if you wish a reply. 








Thank you for your cooperation. No postage stamp necessary if mailed in the U.S.A. 
(Elsewhere, an IBM office or representative will be happy to forward your comments.) 
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